Enrico Nicoletto
liverig@gmail.com 2013.
Willber Nascimento
willberufal@gmail.com 2019.

# Ferramentas de construção

      O intuito das ferramentas de construção é o de criar documentos nos formatos PDF, DVI ou PS.

# Introdução

Várias ferramentas diferentes podem ser usadas para compilar um documento. Existem alguns comandos de baixo nível, e uma ferramenta de alto nível: Latexmk.

## Comandos de baixo nível

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

Compilar um documento LaTeX pode envolver executar vários comandos de baixo nível, em uma certa ordem e um certo número de vezes. Aqui está um exemplo:

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

Usar uma ferramenta de alto nível tal como Latexmk simplifica muito todo esse processo, uma vez que somente um comando é requerido. De fato, Latexmk pode detectar quantas vezes o comando latex ou pdflatex deve ser chamado, e se bibtex ou makeindex é requerido. Por padrão, GNOME LaTeX usa Latexmk.

# Executando uma ferramenta de construção

Existem vários meios para executar uma ferramenta de construção:

Abra o menu Construir.

Use os botões da barra de ferramentas principal.

Use os atalhos de teclado: F2 → F11.

A ferramenta de construção é executada no arquivo que está aberto no momento. Se o arquivo pertence a um projeto, ele é executado no arquivo principal do projeto.

## Ferramentas de construção ocultas

Por padrão, muitas ferramentas estão ocultas, logo elas não podem ser executadas. Para visualizar a lista completa de ferramentas de construção, as ative ou as configure, leia a seção .

# Configurações gerais

Para configurar as ferramentas de construção, vá para: Construir Gerenciar ferramentas de construção

Você verá a lista de todas as ferramentas de construção padrão, e uma segunda lista com suas ferramentas de construção pessoal. Existem botões de verificação para habilitar ou desabilitá-las. Quando uma ferramenta de construção é desabilitada, não é possível executá-la. Você pode realizar algumas ações, como mover uma ferramenta para cima ou para baixo, abrir suas propriedades, deletar ou copiá-la, criar uma nova, etc.

Clique duplo sobre uma ferramenta de construção abrirá suas propriedades.

# Trabalhos de uma ferramenta de construção

Nas propriedades de uma ferramenta de construção, a parte complicada é configurar os trabalhos. Uma ferramenta de construção pode executar vários trabalhos. Cada trabalho contém duas partes de informação:

O comando, que pode usar lugares reservados.

O pós-processador (veja ).

Quando um erro ocorre durante a execução de um trabalho, a execução da ferramenta de construção é abortada, então os próximos trabalhos não são lançados.

# Pós-processadores

O propósito de um pós-processador é o de filtrar a saída do comando e extrair suas informações úteis. Quatro pós-processadores estão disponíveis:

## no-output

A saída simplesmente não é exibida.

## all-output

Toda saída é apresentada, sem filtro.

## latex

Filtra a saída dos comandos latex ou pdflatex. Pode haver três tipos de erros: erros críticos, advertências, ou bad boxes. Há também outras informações úteis: o tamanho do documento, o número de páginas e o número de erros.

## latexmk

Usado para o comando latexmk. Internamente, esse pós-processador usa outros: latex e all-output.