<?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="gl">

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Fran Dieguez</mal:name>
      <mal:email>frandieguez@gnome.org</mal:email>
      <mal:years>2011.</mal:years>
    </mal:credit>
  </info>

<title>Ferramentas de construción</title>

<synopsis>
  <p>O propósito das ferramentas de construción é xerar un documento en formato PDF, DVI ou PS</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Introdución</title>

  <p>Several different tools can be used for a document compilation. There are some
  low-level commands, and one higher-level tool: Latexmk.</p>

  <table rules="rowgroups">
    <title>Ordes de baixo nivel</title>
    <thead>
      <tr>
        <td><p>Etiqueta</p></td>
        <td><p>Orde</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>Bibliografía</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 un documento LaTeX pode involucrar a execución de varias ordes de baixo nivel, en certa orde e certo número de veces. Aquí ten un 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>Using a higher-level tool such as Latexmk simplify a lot all this process,
  since only one command is required. Indeed, Latexmk can detect how many times the
  <cmd>latex</cmd> or <cmd>pdflatex</cmd> command must be called, and whether
  <cmd>bibtex</cmd> or <cmd>makeindex</cmd> is required. By default, GNOME LaTeX
  uses Latexmk.</p>
</section>

<section id="execute">
  <title>Exeuctar unha ferramenta de construción</title>

  <p>Hai varios significados para executar unha ferramenta de construción:</p>
  <list>
    <item><p>Open the <gui style="menu">Build</gui> menu.</p></item>
    <item><p>Use the buttons in the main toolbar.</p></item>
    <item><p>Use o atallo de teclado: <key>F2</key> → <key>F11</key>.</p></item>
  </list>

  <p>The build tool is executed on the currently opened file. If the file belongs to a
  <link xref="projects">project</link>, it is executed on the project's main file.</p>

  <note style="important">
    <title>Ferramentas de construción ocultas</title>
    <p>Por omisión, moitas das ferramentas de construción están agochadas, polo que non poden ser executadas, activadas ou configuradas, lea a sección <link xref="#general_configuration"/>.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Configuración xeral</title>

  <p>
    To configure the build tools, go to:
    <guiseq>
      <gui style="menu">Build</gui>
      <gui style="menu">Manage Build Tools</gui>
    </guiseq>
  </p>

  <p>You will see the list of all the default build tools, and a second list
  with your personal build tools. There are check buttons to enable or disable
  them. When a build tool is disabled, it's not possible to execute it. You can
  perform some actions, like moving a tool up or down, open its properties,
  delete or copy it, create a new one, etc.</p>

  <note style="tip">
    <p>Prema dúas veces sobre unha ferramenta de construción para abrir as súas propiedades.</p>
  </note>
</section>

<section id="jobs">
  <title>Traballos dunha ferramenta de construción</title>

  <p>In the properties of a build tool, the tricky part is to configure the jobs.
  A build tool can execute several jobs. Each job contains two pieces of
  information:</p>
  <list>
    <item><p>A orde, que pode empregar posicionadores.</p></item>
    <item><p>O postprocesador (vexa <link xref="#post-processors"/>).</p></item>
  </list>

  <p>When an error occurs during a job's execution, the execution of the build
  tool is aborted, so the next jobs are not launched.</p>
</section>

<section id="post-processors">
  <title>Postprocesador</title>
  <p>The purpose of a post processor is to filter the command output and extract
  the useful information. Four post processors are available:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>A saída simplemente non se mostra</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>Móstrase toda a saída, sen filtrar.</p>
    </item>
    <item>
      <title its:translate="no">latex</title>
      <p>Filtra a saída das ordes <cmd>latex</cmd> ou <cmd>pdflatex</cmd>. Pode haber tres tipos de erros: erros críticos, avisos, e caixas incorrectas. Tamén hai algunha información útil: o tamaño do documento, o número de páxinas e o número de erros.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Usado pola orde <cmd>latexmk</cmd>. De forma interna, este postprocesador usa outros: <em>latex</em> e <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
