Sébastien Wilmet
swilmet@gnome.org 2011-2015
Bruno Brouard
annoa.b@gmail.com 2011-2012
Alain Lojewski
allomervan@gmail.com 2012

# Outils de construction

      Le but des outils de construction est de générer un document au format PDF, DVI ou PS.

# Introduction

Plusieurs outils différents peuvent être utilisés pour la compilation d'un document. Il y a des commandes de bas niveau et un outil de haut niveau : Latexmk.

## Commandes de bas niveau

Étiquette | Commande
--- | ---
LaTeX → DVI | latex
LaTeX → PDF | pdflatex
DVI → PDF | dvipdf
DVI → PS | dvips
PS → PDF | ps2pdf
Bibliographie | bibtex
Index | makeindex

Compiler un document LaTeX implique parfois d'exécuter plusieurs commandes de bas niveau, dans un certain ordre et un certain nombre de fois. Par exemple :

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

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 latex or pdflatex command must be called, and whether bibtex or makeindex is required. By default, GNOME LaTeX uses Latexmk.

# Lancement d'un outil de construction

Il y a plusieurs façons de lancer un outil de construction :

Ouvrir le menu Construction.

Utiliser les boutons de la barre d'outils principale.

Utiliser les raccourcis clavier : F2 → F11.

L'outil de construction est lancé sur le fichier actuellement ouvert. Si le fichier fait partie d'un projet, l'exécution se fait sur le fichier principal du projet.

## Outils de construction cachés

Par défaut, beaucoup d'outils de construction sont cachés, donc ils ne peuvent pas être exécutés. Pour consulter la liste complète des outils de construction, les activer ou les configurer, lisez la section .

# Configuration générale

Pour configurer les outils de construction, allez dans : Construction Gérer les outils de construction

Vous y trouverez une liste contenant tous les outils de construction par défaut, ainsi qu'une seconde liste contenant vos outils de construction personnels. Il y a des cases à cocher pour les activer ou les désactiver. Quand un outil de construction est désactivé, il n'est pas possible de l'exécuter. Vous pouvez réaliser certaines actions, comme déplacer un outil vers le haut ou le bas, ouvrir ses propriétés, le supprimer ou en faire une copie, en créer un nouveau, etc.

Un double clic sur un outil de construction permet d'ouvrir ses propriétés.

# Tâches d'un outil de construction

Dans les propriétés d'un outil de construction, la partie difficile est de configurer les tâches. Un outil de construction peut exécuter plusieurs tâches. Chaque tâche contient deux informations :

La commande, qui peut utiliser des marques substitutives.

Le post-processeur (consultez la section ).

Si une erreur survient lors de l'exécution d'une tâche, l'exécution de l'outil de construction est interrompue, et les nouvelles tâches ne sont pas lancées.

# Post-processeurs

Le but d'un post-processeur est de filtrer la sortie de la commande et d'en extraire les informations utiles. Quatre post-processeurs sont disponibles :

## no-output

La sortie n'est simplement pas affichée.

## all-output

Toutes les sorties sont affichées, sans aucun filtrage.

## latex

Filtre la sortie des commandes latex et pdflatex. Il peut y avoir trois types d'erreurs : des erreurs critiques, des avertissements ou des « bad box ». Il y a aussi quelques autres informations utiles : la taille du document, le nombre de pages et le nombre d'erreurs.

## latexmk

Utilisé pour la commande latexmk. En interne, ce post-processeur en utilise d'autres : latex et all-output.