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

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

<title>Nástroje pro sestavení</title>

<synopsis>
  <p>Účelem nástrojů pro sestavení je vygenerovat dokument ve formátu PDF, DVI nebo PS.</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Úvod</title>

  <p>Pro sestavení dokumentu je možné použít různé nástroje. Zde je několik nízkoúrovňových příkazů a jeden vysokoúrovňový: Latexmk.</p>

  <table rules="rowgroups">
    <title>Nízkoúrovňové příkazy</title>
    <thead>
      <tr>
        <td><p>Popisek</p></td>
        <td><p>Příkaz</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>Bibliografie</p></td>
        <td its:translate="no"><p><cmd>bibtex</cmd></p></td>
      </tr>
      <tr>
        <td><p>Rejstřík</p></td>
        <td its:translate="no"><p><cmd>makeindex</cmd></p></td>
      </tr>
    </tbody>
  </table>

  <p>Sestavení dokumentu LaTeX může vyvolat spuštění několika nízkoúrovňových příkazů a to v určitém pořadí a i několikrát. Zde je příklad:</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,
  <app>Enter TeX</app> uses Latexmk.</p>
</section>

<section id="execute">
  <title>Spuštění nástroje pro sestavení</title>

  <p>Existuje několik způsobů, jak spustit nástroj pro sestavení:</p>
  <list>
    <item><p>Open the <gui style="menu">Build</gui> menu.</p></item>
    <item><p>Použijte tlačítko na hlavní liště nástrojů.</p></item>
    <item><p>Use the shortcut: <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>Skryté nástroje pro sestavení</title>
    <p>By default, a lot of build tools are hidden, so they can't be executed. To view
    the full list of build tools, activate or configure them, read the
    <link xref="#general_configuration"/> section.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Obecné nastavení</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>Uvidíte úplný seznam výchozích nástrojů pro sestavení a druhý seznam s osobními nástroji pro sestavení. U nich je zaškrtávací políčko, které je povolí nebo zakáže. Když je nástroj pro sestavení zakázaný, není možné jej spustit. Můžete provádět některé další věci, jako je přesouvání níže nebo výše, otevření vlastností nástroje, jeho smazaní nebo kopírovaní, vytváření nového atd.</p>

  <note style="tip">
    <p>Dvojitým kliknutím na nástroj pro sestavení se otevřou jeho vlastnosti.</p>
  </note>
</section>

<section id="jobs">
  <title>Úlohy nástroje pro sestavení</title>

  <p>Ve vlastnostech nástroje pro sestavení je nejpodstatnější částí nastavení úloh. Nástroj pro sestavení může úloh spouštět několik. Každá z úloh obsahuje dvě informace:</p>
  <list>
    <item><p>Příkaz, který může využívat zástupných proměnných.</p></item>
    <item><p>The post processor (see <link xref="#post-processors"/>).</p></item>
  </list>

  <p>Jestliže se během provádění úlohy vyskytne chyba, je běh nástroje pro sestavení přerušen a kvůli tomu nejsou spuštěny ani následující úlohy.</p>
</section>

<section id="post-processors">
  <title>Dodatečné zpracování</title>
  <p>Účelem dodatečného zpracování je filtrovat výstup příkazu a získat z něj použitelné informace. K dispozici jsou čtyři postprocesory:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>Výstup se prostě nezobrazí.</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>Veškerý výstup se bez omezení zobrazí.</p>
    </item>
    <item>
      <title its:translate="no">latex</title>
      <p>Filter the output of the <cmd>latex</cmd> or <cmd>pdflatex</cmd> commands.
      There can be three types of errors: critical errors, warnings, or bad boxes. There
      are also some other useful information: the size of the document, the number of
      pages, and the number of errors.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Used for the <cmd>latexmk</cmd> command. Internally, this post processor uses
      other ones: <em>latex</em> and <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
