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

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Алексей Кабанов</mal:name>
      <mal:email>ak099@mail.ru</mal:email>
      <mal:years>2012</mal:years>
    </mal:credit>
  </info>

<title>Инструменты сборки</title>

<synopsis>
  <p>Назначение инструментов сборки — сгенерировать документ в формате PDF, DVI или PS.</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Введение</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>Низкоуровневые команды</title>
    <thead>
      <tr>
        <td><p>Label</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>Index</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, GNOME LaTeX
  uses 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>Инструмент сборки применяется к текущему открытому файлу. Если файл принадлежит к <link xref="projects">проекту</link>, инструмент применяется к главному файлу проекта.</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>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>The command, which can use placeholders.</p></item>
    <item><p>Постобработчик (смотрите <link xref="#post-processors"/>).</p></item>
  </list>

  <p>Если при выполнении задания возникает ошибка, работа инструмента сборки прерывается, и следующее задание запущено не будет.</p>
</section>

<section id="post-processors">
  <title>Постобработчики</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>Вывод просто не отображается.</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>
