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

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Piotr Drąg</mal:name>
      <mal:email>piotrdrag@gmail.com</mal:email>
      <mal:years>2017</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Aviary.pl</mal:name>
      <mal:email>community-poland@mozilla.org</mal:email>
      <mal:years>2017</mal:years>
    </mal:credit>
  </info>

<title>Narzędzia budowania</title>

<synopsis>
  <p>Narzędzia budowania służą do tworzenia dokumentów w formatach PDF, DVI lub PostScript.</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Wprowadzenie</title>

  <p>Do kompilowania dokumentów można używać kilka różnych narzędzi. Niektóre są poleceniami niskiego poziomu, a jedno jest narzędziem wyższego poziomu: Latexmk.</p>

  <table rules="rowgroups">
    <title>Polecenia niskopoziomowe</title>
    <thead>
      <tr>
        <td><p>Etykieta</p></td>
        <td><p>Polecenie</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>Bibliografia</p></td>
        <td its:translate="no"><p><cmd>bibtex</cmd></p></td>
      </tr>
      <tr>
        <td><p>Indeks</p></td>
        <td its:translate="no"><p><cmd>makeindex</cmd></p></td>
      </tr>
    </tbody>
  </table>

  <p>Kompilowanie dokumentu LaTeX obejmuje wykonanie kilku poleceń niskiego poziomu w określonej kolejności i określoną liczbę razy. Przykład:</p>
  <screen its:translate="no">
$ latex document.tex
$ bibtex document.aux
$ latex document.tex
$ dvips -t a4 document.dvi
$ ps2pdf document.ps</screen>

  <p>Użycie narzędzia wyższego poziomu, takiego jak Latexmk, upraszcza ten proces, jako że wymaga to tylko jednego polecenia. Latexmk samo wykrywa, ile razy trzeba wywołać polecenia <cmd>latex</cmd> i <cmd>pdflatex</cmd> oraz czy wymagane są polecenia <cmd>bibtex</cmd> i <cmd>makeindex</cmd>. Domyślnie LaTeXila używa narzędzia Latexmk.</p>
</section>

<section id="execute">
  <title>Wykonywanie narzędzia budowania</title>

  <p>Istnieje kilka sposób wykonywania narzędzia budowania:</p>
  <list>
    <item><p>Otwarcie menu <gui style="menu">Budowanie</gui>.</p></item>
    <item><p>Użycie przycisków na głównym pasku narzędziowym.</p></item>
    <item><p>Użycie skrótu <key>F2</key> → <key>F11</key>.</p></item>
  </list>

  <p>Narzędzie budowania jest wykonywane na obecnie otwartym pliku. Jeśli plik należy do <link xref="projects">projektu</link>, to jest ono wykonywane na głównym pliku projektu.</p>

  <note style="important">
    <title>Ukryte narzędzia budowania</title>
    <p>Domyślnie wiele narzędzi budowania jest ukrytych, więc nie mogą być wykonywane. Sekcja <link xref="#general_configuration"/> zawiera pełną listę narzędzi budowania oraz informacje o ich włączaniu i konfigurowaniu.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Ogólna konfiguracja</title>

  <p>Aby skonfigurować narzędzia budowania, przejdź do <guiseq> <gui style="menu">Budowanie</gui> <gui style="menu">Zarządzaj narzędziami budowania</gui> </guiseq></p>

  <p>Zostanie wyświetlona lista wszystkich domyślnych narzędzi budowania oraz druga lista zawierająca narzędzia użytkownika. Obok narzędzi znajdują się przyciski do ich włączania/wyłączania. Kiedy narzędzie jest wyłączone, to nie można go wykonywać. Można wykonywać pewne działania, na przykład przenoszenie narzędzia w górę i w dół, otwieranie jego właściwości, usuwanie lub kopiowanie go, tworzenie nowego itd.</p>

  <note style="tip">
    <p>Podwójne kliknięcie narzędzia budowania otworzy jego właściwości.</p>
  </note>
</section>

<section id="jobs">
  <title>Zadania narzędzia budowania</title>

  <p>Najtrudniejszą częścią właściwości narzędzia budowania jest konfigurowanie zadań. Narzędzie może wykonywać kilka zadań. Każde zadanie zawiera dwie informacje:</p>
  <list>
    <item><p>Polecenie, które może zawierać symbole zastępcze.</p></item>
    <item><p>Przetwarzanie końcowe (więcej informacji: <link xref="#post-processors"/>).</p></item>
  </list>

  <p>Po wystąpieniu błędu podczas wykonywania zadania wykonywanie narzędzia budowania zostaje przerwane, więc następne zadania nie są uruchamiane.</p>
</section>

<section id="post-processors">
  <title>Przetwarzanie końcowe</title>
  <p>Przetwarzanie końcowe służy do filtrowania wyjścia polecenia i wydobywania z niego przydatnych informacji. Dostępne są cztery rodzaje przetwarzania końcowego:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>Wyjście nie jest wyświetlane.</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>Całość wyjścia jest wyświetlana bez filtrowania.</p>
    </item>
    <item>
      <title its:translate="no">latex</title>
      <p>Filtrowanie wyjścia poleceń <cmd>latex</cmd> i <cmd>pdflatex</cmd>. Są trzy typy błędów: błędy krytyczne, ostrzeżenia i błędne pudełka. Przydatne są także inne informacje: rozmiar dokumentu, liczba stron i liczba błędów.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Używane dla polecenia <cmd>latexmk</cmd>. Wewnętrznie to przetwarzanie końcowe używa innych: <em>latex</em> i <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
