Daniel Mustieles
daniel.mustieles@gmail.com 2011-2017

# Herramientas de construcción

      El propósito de las herramientas de construcción es generar un documento en formato PDF, DVI o PS.

# Introducción

Se pueden usar varias herramientas para compilar documentos. Hay algunos comandos de bajo nivel y una herramienta de alto nivel: Latexmk.

## Comandos de bajo nivel

Etiqueta | Comando
--- | ---
LaTeX → DVI | latex
LaTeX → PDF | pdflatex
DVI → PDF | dvipdf
DVI → PS | dvips
PS → PDF | ps2pdf
Bibliografía | bibtex
Índice | makeindex

Compilar un documento LaTeX puede implicar tener que ejecutar varios comandos de bajo nivel, en determinado orden y cierto número de veces. Aquí hay un ejemplo:

    $ latex document.tex
    $ bibtex document.aux
    $ latex document.tex
    $ dvips -t a4 document.dvi
    $ ps2pdf document.ps

Usar una herramienta de alto nivel como Latexmk simplifica mucho este proceso, ya que sólo se requiere un comando. En realidad, Latexmk puede detectar cuántas veces se deben usar los comandos latex o pdflatex, y si se necesita bibtex o makeindex. De manera predeterminada, GNOME LaTeX usa Latexmk.

# Ejecutar una herramienta de construcción

Hay varias maneras de ejecutar una herramienta de construcción:

Abrir el menú Construir.

Usar los botones en la barra de herramientas principal.

Use el atajo de teclado: F2 → F11.

La herramienta de construcción se ejecute sobre el archivo abierto actualmente. Si el archivo pertenece a un proyecto, se ejecuta sobre el archivo principal del proyecto.

## Herramientas de construcción ocultas

De manera predeterminada, hay muchas herramientas de construcción ocultas. Para ver la lista completa de herramientas de construcción, activarlas o configurarlas, consulte la .

# Configuración general

Para configurar las herramientas de construcción, vaya a: Construir Gestionar herramientas de construcción

Verá una lista de todas las herramientas de construcción, y una segunda lista con sus herramientas personales de construcción. Hay casillas para mostrarlas u ocultarlas. Cuando una herramienta de construcción está oculta, no es posible ejecutarla. Puede realizar algunas acciones, como mover una herramienta, abrir sus propiedades, eliminarla, copiarla, crear una nueva, etc.

Una pulsación doble sobre una herramienta de construcción mostrará sus propiedades.

# Tareas de una herramienta de construcción

En las propiedades de una herramienta de construcción, la parte complicada es configurar las tareas. Una herramienta de construcción puede ejecutar varias tareas. Cada tarea contiene dos fragmentos de información:

El comando, que puede usar marcadores de posición.

El post-procesador (consulte la ).

Cuando ocurre un error durante la ejecución de una tarea, se cancela la ejecución de la herramienta de construcción, por lo que los siguientes trabajos no se lanzan.

# Post-procesadores

El propósito de un post-procesador es filtrar la información de salida del comando y extraer la información útil. Hay cuatro post-procesadores disponibles:

## no-output

La salida simplemente no se muestra.

## all-output

Se muestra toda la salida, sin filtrar.

## latex

Filtrar la salida de los comandos latex o pdflatex. Puede haber tres tipos de errores: errores críticos, advertencias o «bad boxes». También hay alguna información útil: el tamaño del documento, el número de páginas y el número de errores.

## latexmk

Usado por el comando latexmk. Internamente, este post-procesador usa otros: latex y all-output.