Piotr Drąg
piotrdrag@gmail.com 2017-2018
Aviary.pl
community-poland@mozilla.org 2017-2018

# Narzędzia budowania

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

# Wprowadzenie

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.

## Polecenia niskopoziomowe

Etykieta | Polecenie
--- | ---
LaTeX → DVI | latex
LaTeX → PDF | pdflatex
DVI → PDF | dvipdf
DVI → PS | dvips
PS → PDF | ps2pdf
Bibliografia | bibtex
Indeks | makeindex

Kompilowanie dokumentu LaTeX obejmuje wykonanie kilku poleceń niskiego poziomu w określonej kolejności i określoną liczbę razy. Przykład:

    $ latex document.tex
    $ bibtex document.aux
    $ latex document.tex
    $ dvips -t a4 document.dvi
    $ ps2pdf document.ps

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 latex i pdflatex oraz czy wymagane są polecenia bibtex i makeindex. Domyślnie GNOME LaTeX używa narzędzia Latexmk.

# Wykonywanie narzędzia budowania

Istnieje kilka sposób wykonywania narzędzia budowania:

Otwarcie menu Budowanie.

Użycie przycisków na głównym pasku narzędziowym.

Użycie skrótu F2 → F11.

Narzędzie budowania jest wykonywane na obecnie otwartym pliku. Jeśli plik należy do projektu, to jest ono wykonywane na głównym pliku projektu.

## Ukryte narzędzia budowania

Domyślnie wiele narzędzi budowania jest ukrytych, więc nie mogą być wykonywane. Sekcja zawiera pełną listę narzędzi budowania oraz informacje o ich włączaniu i konfigurowaniu.

# Ogólna konfiguracja

Aby skonfigurować narzędzia budowania, przejdź do Budowanie Zarządzaj narzędziami budowania

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.

Podwójne kliknięcie narzędzia budowania otworzy jego właściwości.

# Zadania narzędzia budowania

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:

Polecenie, które może zawierać symbole zastępcze.

Przetwarzanie końcowe (więcej informacji: ).

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

# Przetwarzanie końcowe

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:

## no-output

Wyjście nie jest wyświetlane.

## all-output

Całość wyjścia jest wyświetlana bez filtrowania.

## latex

Filtrowanie wyjścia poleceń latex i pdflatex. 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.

## latexmk

Używane dla polecenia latexmk. Wewnętrznie to przetwarzanie końcowe używa innych: latex i all-output.