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

<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>Použití nástrojů vyšší úrovně, jako je Latexmk, zjednodušuje velkou část tohoto procesu, protože stačí jediný příkaz. Je samozřejmostí, že umí tyto nástroje zjistit, kolikrát se musí zavolat příkazy <cmd>latex</cmd> nebo <cmd>pdflatex</cmd> a zda je potřeba příkaz <cmd>bibtex</cmd> nebo <cmd>makeindex</cmd>. Jako výchozí používá aplikace LaTeXila nástroj 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>Otevřete nabídku <gui style="menu">Sestavit</gui>.</p></item>
    <item><p>Použijte tlačítko na hlavní liště nástrojů.</p></item>
    <item><p>Použijte klávesovou zkratku: <key>F2</key> → <key>F11</key>.</p></item>
  </list>

  <p>Nástroj pro sestavení je spuštěn na právě otevřeném souboru. Pokud soubor náleží do <link xref="projects">projektu</link>, je zpracování provedeno na hlavním souboru projektu.</p>

  <note style="important">
    <title>Skryté nástroje pro sestavení</title>
    <p>Ve výchozím stavuj je hodně nástrojů pro sestavení skrytých, takže je není možné spustit. Abyste viděli jejich úplný seznam, musíte je aktivovat nebo nastavit, viz oddíl <link xref="#general_configuration"/>.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Obecné nastavení</title>

  <p>Když chcete nástroj pro sestavení nastavit, běžte na: <guiseq> <gui style="menu">Sestavit</gui> <gui style="menu">Správa nástrojů pro sestavení</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>Dodatečné zpracování postprocesorem (viz <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>Filtruje výstup příkazů <cmd>latex</cmd> nebo <cmd>pdflatex</cmd>. Mohou se vyskytnout tři typy chyb: kritické chyby, varování nebo chybné oblasti. K dispozici jsou také některé užitečné informace: velikost dokumentu, počet stránek a počet chyb.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Používá se pro příkaz <cmd>latexmk</cmd>. Interně tento postprocesor používá další: <em>latex</em> a <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
