<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" id="build_tools" xml:lang="pt-BR">

<info>
  <link type="guide" xref="index"/>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Enrico Nicoletto</mal:name>
      <mal:email>liverig@gmail.com</mal:email>
      <mal:years>2013.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Willber Nascimento</mal:name>
      <mal:email>willberufal@gmail.com</mal:email>
      <mal:years>2019.</mal:years>
    </mal:credit>
  </info>

<title>Ferramentas de construção</title>

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

<links type="section"/>

<section id="overview">
  <title>Introdução</title>

  <p>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.</p>

  <table rules="rowgroups">
    <title>Comandos de baixo nível</title>
    <thead>
      <tr>
        <td><p>Etiqueta</p></td>
        <td><p>Comando</p></td>
      </tr>
    </thead>
    <tbody its:translate="no">
      <tr>
        <td><p>LaTeX → DVI</p></td>
        <td><p><cmd>latex</cmd></p></td>
      </tr>
      <tr>
        <td><p>LaTeX → PDF</p></td>
        <td><p><cmd>pdflatex</cmd></p></td>
      </tr>
    </tbody>
    <tbody its:translate="no">
      <tr>
        <td><p>DVI → PDF</p></td>
        <td><p><cmd>dvipdf</cmd></p></td>
      </tr>
      <tr>
        <td><p>DVI → PS</p></td>
        <td><p><cmd>dvips</cmd></p></td>
      </tr>
      <tr>
        <td><p>PS → PDF</p></td>
        <td><p><cmd>ps2pdf</cmd></p></td>
      </tr>
    </tbody>
    <tbody>
      <tr>
        <td><p>Bibliografia</p></td>
        <td its:translate="no"><p><cmd>bibtex</cmd></p></td>
      </tr>
      <tr>
        <td><p>Índice</p></td>
        <td its:translate="no"><p><cmd>makeindex</cmd></p></td>
      </tr>
    </tbody>
  </table>

  <p>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:</p>
  <screen its:translate="no">
$ latex document.tex
$ bibtex document.aux
$ latex document.tex
$ dvips -t a4 document.dvi
$ ps2pdf document.ps</screen>

  <p>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 <cmd>latex</cmd> ou <cmd>pdflatex</cmd> deve ser chamado, e se <cmd>bibtex</cmd> ou <cmd>makeindex</cmd> é requerido. Por padrão, GNOME LaTeX usa Latexmk.</p>
</section>

<section id="execute">
  <title>Executando uma ferramenta de construção</title>

  <p>Existem vários meios para executar uma ferramenta de construção:</p>
  <list>
    <item><p>Abra o menu <gui style="menu">Construir</gui>.</p></item>
    <item><p>Use os botões da barra de ferramentas principal.</p></item>
    <item><p>Use os atalhos de teclado: <key>F2</key> → <key>F11</key>.</p></item>
  </list>

  <p>A ferramenta de construção é executada no arquivo que está aberto no momento. Se o arquivo pertence a um <link xref="projects">projeto</link>, ele é executado no arquivo principal do projeto.</p>

  <note style="important">
    <title>Ferramentas de construção ocultas</title>
    <p>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 <link xref="#general_configuration"/>.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Configurações gerais</title>

  <p>Para configurar as ferramentas de construção, vá para: <guiseq> <gui style="menu">Construir</gui> <gui style="menu">Gerenciar ferramentas de construção</gui> </guiseq></p>

  <p>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.</p>

  <note style="tip">
    <p>Clique duplo sobre uma ferramenta de construção abrirá suas propriedades.</p>
  </note>
</section>

<section id="jobs">
  <title>Trabalhos de uma ferramenta de construção</title>

  <p>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:</p>
  <list>
    <item><p>O comando, que pode usar lugares reservados.</p></item>
    <item><p>O pós-processador (veja <link xref="#post-processors"/>).</p></item>
  </list>

  <p>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>
</section>

<section id="post-processors">
  <title>Pós-processadores</title>
  <p>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:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>A saída simplesmente não é exibida.</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>Toda saída é apresentada, sem filtro.</p>
    </item>
    <item>
      <title its:translate="no">latex</title>
      <p>Filtra a saída dos comandos <cmd>latex</cmd> ou <cmd>pdflatex</cmd>. 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.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Usado para o comando <cmd>latexmk</cmd>. Internamente, esse pós-processador usa outros: <em>latex</em> e <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
