Josef Andersson
josef.andersson@fripost.org 2016

# Byggverktyg

      Syftet med byggverktygen är att generera ett dokument i PDF-, DVI- eller PS-format.

# Introduktion

Flera olika verktyg kan användas för dokumentkompilering. Det finns några lågnivåkommandon och ett högnivåverktyg: Latexmk.

## Lågnivåkommandon

Etikett | Kommando
--- | ---
LaTeX → DVI | latex
LaTeX → PDF | pdflatex
DVI → PDF | dvipdf
DVI → PS | dvips
PS → PDF | ps2pdf
Bibliografi | bibtex
Index | makeindex

Att kompilera ett LaTeX-dokument kan innebära körning av flera lågnivåkommandon i speciell ordning och ett speciellt antal gånger. Här är ett exempel:

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

Att använda ett verktyg på högre nivå som t.ex. Latexmk förenklar en hel del av denna process eftersom endast ett kommando krävs. Latexmk kan upptäcka hur många gånger kommandot latex eller pdflatex måste anropas och huruvida bibtex eller makeindex krävs. Som standard använder GNOME LaTeX Latexmk.

# Kör ett byggverktyg

Det finns flera sätta att köra ett byggverktyg på:

Öppna menyn Bygg.

Använd knapparna i huvudverktygsfältet.

Använd genvägen: F2 → F11.

Byggverktyget körs på den fil som är öppnad för tillfället. Om filen tillhör ett projekt körs den med projektets huvudfil.

## Dolda byggverktyg

Som standard är många byggverktyg dolda så att de inte kan köras. För att se hela listan av byggverktyg, aktivera eller konfigurera dem, läs avsnittet .

# Allmän konfiguration

För att konfigurera byggverktygen, gå till Bygg Hantera byggverktyg

Du kommer att se en lista över alla standardbyggverktyg och en till lista med dina personliga byggverktyg. Det finns kryssruteknappar för att aktivera och inaktivera dem. När ett byggverktyg är inaktiverat är det inte möjligt att köra det. Du kan utföra en del åtgärder som att flytta ett verktyg upp eller ned, öppna dess egenskaper, ta bort eller kopiera det, skapa ett nytt, o.s.v.

Dubbelklick på ett byggverktyg kommer att öppna dess egenskaper.

# Jobben för ett byggverktyg

I egenskaperna för ett byggverktyg är den kluriga delen att konfigurera jobben. Ett byggverktyg kan exekvera flera jobb. Varje jobb innehåller två delar information:

Kommandot som kan använda platshållare.

Postprocessorn (se ).

När ett fel uppstår då ett jobb exekveras, kommer exekveringen att avbrytas så att efterföljande jobb inte startas.

# Postprocessorer

Syftet med en postprocessor är att filtrera kommandoutdata och extrahera den användbara informationen. Fyra postprocessorer är tillgängliga:

## no-output

Utmatningen visas inte.

## all-output

All utmatning visas, utan filter.

## latex

Filtrera utmatningen för kommandona latex eller pdflatex. Det kan finnas tre typer av fel: kritiska fel, varningar eller felrutor. Det finns också en del annan användbar information: storleken på dokumenten, antalet sidor och antalet fel.

## latexmk

Används för kommandot latexmk. Internt använder denna postprocessor andra kommandon: latex och all-output.