28 Interface ligne de commande

Synopsis (depuis la ligne de commande d’un terminal) :

pdflatex options argument

Exécute LaTeX sur argument. À la place de pdflatex vous pouvez aussi utiliser (pour une sortie PDF) xelatex, ou lualatex, ou (pour une sortie DVI) latex ou dvilualatex, entre autres (voir TeX engines).

L’exemple suivant exécute LaTeX sur le fichier these.tex produisant en sortie these.pdf.

pdflatex these

Notez que .tex est l’extension par défaut des noms de fichier.

pdfTeX est une évolution du programme original TeX, comme le sont XeTeX et LuaTeX (voir TeX engines). Ils sont complètement rétrocompatibles. Mais le programme original avait son propre format de sortie, DVI, alors que les plus récents peuvent produire directement un PDF en sortie. Ceci leur permet de profiter des fonctions supplémentaires des PDF tels que les hyperliens, la prise en charge de formats modernes d’images tels que JPG et PNG, et les programmes de visionnage que l’on trouve de partout. En bref, si vous exécutez pdflatex ou xelatex ou lualatex alors par défaut vous obtenez un PDF et avez accès à toutes ses fonctions modernes. Si vous exécutez latex, ou dvilualatex, alors vous obtenez un DVI. La description faite ici suppose pdflatex.

Voir Command line options, pour une sélection des options de ligne de commande les plus utiles. Quant à argument, le cas habituel est qu’il ne commence pas par une controblique, dans ce cas le système le prend pour un nom de fichier, et compile ce fichier. Si argument commence avec une controblique, alors le système l’interprète comme une ligne d’entrée à LaTeX, ce qui peut être utilisé pour obtenir certains effets spéciaux (voir Command line input).

Si vous ne donnez aucun arguments ni options alors pdflatex invite à saisir à partir du terminal. Vous pouvez vous échapper de cela en entrant CTRL-D.

Si LaTeX trouve une erreur dans votre document alors par défaut il s’arrête et vous interroge à ce propos. Voir Recovering from errors, pour un aperçu de quoi faire.