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

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Юрій Чорноіван</mal:name>
      <mal:email>yurchor@ukr.net</mal:email>
      <mal:years>2015, 2020</mal:years>
    </mal:credit>
  </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>Використання високорівневого засобу, зокрема Latexmk, значно спрощує увесь процес, оскільки для його виконання потрібна лише одна команда. Зокрема, Latexmk може визначити кількість потрібних для обробки даних запусків команд <cmd>latex</cmd> та <cmd>pdflatex</cmd>, а також те, чи слід запускати <cmd>bibtex</cmd> і <cmd>makeindex</cmd>. У GNOME LaTeX типово використовується саме Latexmk.</p>
</section>

<section id="execute">
  <title>Запуск засобу збирання</title>

  <p>Передбачено декілька способів запуску засобу збирання:</p>
  <list>
    <item><p>За допомогою меню <gui style="menu">Збирання</gui>.</p></item>
    <item><p>За допомогою кнопок на основній панелі інструментів.</p></item>
    <item><p>За допомогою клавіатурного скорочення: <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>Типово, багато із засобів збирання приховано, отже напряму скористатися ними неможливо. Щоб ознайомитися із повним списком засобів збирання та способами активації та налаштовування цих засобів, ознайомтеся із розділом <link xref="#general_configuration"/>.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Загальне налаштовування</title>

  <p>Щоб налаштувати засоби збирання, скористайтеся пунктом меню <guiseq> <gui style="menu">Збирання</gui> <gui style="menu">Керування засобами збирання</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>Засобу остаточної обробки (див. <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>Фільтрування даних, виведених командами <cmd>latex</cmd> і <cmd>pdflatex</cmd>. Передбачено три типи помилок: критичні помилки, попередження та вади компонування. Також може бути виведено корисні дані: розмір документа, кількість сторінок та кількість помилок.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Використовується для команди <cmd>latexmk</cmd>. На внутрішньому рівні цей засіб остаточної обробки використовує інші: <em>latex</em> та <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
