<?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>Засоби збирання</title>

<synopsis>
  <p>Засоби збирання призначено для створення документів у форматах PDF, DVI та PS.</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Вступ</title>

  <p>Для збирання документа може бути використано декілька різних засобів. Передбачено декілька низькорівневих команд, а також один високорівневий засіб: Latexmk.</p>

  <table rules="rowgroups">
    <title>Команди низького рівня</title>
    <thead>
      <tr>
        <td><p>Мітка</p></td>
        <td><p>Команда</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>Список літератури</p></td>
        <td its:translate="no"><p><cmd>bibtex</cmd></p></td>
      </tr>
      <tr>
        <td><p>Покажчик</p></td>
        <td its:translate="no"><p><cmd>makeindex</cmd></p></td>
      </tr>
    </tbody>
  </table>

  <p>Процедура компіляції документа LaTeX може включати виконання декількох низькорівневих команд у певному порядку або певну кількість разів. Ось приклад:</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>Запуск засобу збирання</title>

  <p>Передбачено декілька способів запуску засобу збирання:</p>
  <list>
    <item><p>Open the <gui style="menu">Build</gui> menu.</p></item>
    <item><p>За допомогою кнопок на основній панелі інструментів.</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>Приховані засоби збирання</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>Загальне налаштовування</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>Вам буде показано список усіх типових засобів збирання та другий список із вашими особистими засобами збирання. Для вмикання або вимикання засобів передбачено кнопки з позначками. Якщо засіб збирання вимкнено, його не можна буде запустити. Ви також можете виконати певні дії із пунктами засобів збирання, зокрема пересунути пункт вище або нижче списком, відкрити вікно властивостей пункту, вилучити або скопіювати пункт, створити пункт.</p>

  <note style="tip">
    <p>Подвійне клацання лівою кнопкою миші на пункті засобу збирання відкриває вікно властивостей цього засобу.</p>
  </note>
</section>

<section id="jobs">
  <title>Завдання засобу збирання</title>

  <p>Найскладнішим у вікні властивостей засобу збирання є налаштовування завдань. Засіб збирання може виконувати декілька завдань одночасно. Запис кожного із завдань складається з двох елементів:</p>
  <list>
    <item><p>Команди, у якій може бути використано слова-замінники.</p></item>
    <item><p>The post processor (see <link xref="#post-processors"/>).</p></item>
  </list>

  <p>Якщо під час виконання завдання трапляється помилка, виконання засобу збирання переривається, отже наступні завдання у черзі завдань не виконуватимуться.</p>
</section>

<section id="post-processors">
  <title>Засоби остаточної обробки</title>
  <p>Метою остаточної обробки є фільтрування виведених командою даних і видобування корисної інформації. Передбачено чотири засоби остаточної обробки:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>Виведені дані просто не буде показано.</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>Виведені дані буде показано без фільтрування.</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>
