pdftex, pdfinitex, pdfvirtex - sorties −PDF Ã partir de TeX

pdftex [options] [commands]

Cette page de manuel ne se veut pas exhaustive. La documentation complète pour cette version de TeX peut être trouvée dans le fichier info ou le manuel Web2C: A TeX implementation.

pdfTeX est une version de TeX qui peut produire des fichiers PDF comme aussi des fichiers DVI.

L’usage commun de pdfTeX se fonde sur des formats prégénérés pour lesquels une sortie PDF est permise. La commande pdftex utilise l’équivalent du format plain de TeX, et la commande pdflatex utilise l’équivalent du format de LaTeX.

Les commandes pdfinitex et pdfvirtex sont des analogues pdfTeX des commandes initex et virtex. Dans cette installation, elles sont des liens symboliques vers l’exécutable pdftex.

Le maniement des arguments en ligne de commande de pdfTeX est similaire à celui de TeX.

pdfTeX est un logiciel en version bêta.

Cette version de pdfTeX comprend les options en ligne de commande suivantes :

--fmt format

Utilise format comme nom du format à utiliser, au lieu du nom par lequel pdfTeX a été appelé ou une ligne %&.

--help

Affiche le message d’aide et sort.

--ini

Il faut pdfinitex, pour les formats de sortie (dumping formats) ; cela est implicitement vrai si le programme est appelé en tant que pdfinitex.

--interaction mode

Règle le mode interactif. Ce mode peut être un des suivants : batchmode, nonstopmode, scrollmode, et errorstopmode. La signification de ces modes est la même que celle correspondante à \commands.

--ipc

Envoie une sortie DVI ou PDF vers un socket aussi bien que vers le fichier de sortie habituel. Cette option est disponible au choix de l’installateur.

--ipc-start

Comme --ipc, et démarre le serveur aussi bien par l’autre extrémité. Cette option est disponible au choix de l’installateur.

--kpathsea-debug bitmask

Règle le chemin de recherche des flags de déboggage d’après le masque binaire. Voir le manuel Kpathsea pour les détails.

--maketex fmt

Permet mktexfmt, où fmt doit être en tex ou en tfm.

--no-maketex fmt

Ne permet pas mktexfmt, où fmt doit être en tex ou en tfm.

--output-comment string

Fait usage de string pour le commentaire du fichier DVI Ã la place de la date.

--progname name

Feint d’être en nom de programme. Cela affecte à la fois le format utilisé et les chemins de recherche.

--shell-escape

Permet la construction \write18{command} La command peut être n’importe qu’elle commande Bourne shell. Cette construction n’est pas normalement autorisée pour des raisons de sécurité.

--translate-file tcxname

Utilise la table de traduction tcxname.

--version

Affiche l’information sur la version et quitte le programme.

Voir la documentation de la bibliothèque Kpathsearch (le noeud « Path specifications ») pour des détails précis sur la manière dont sont utilisées les variables d’environnement. L’utilitaire kpsewhich peut être appelé pour chercher la valeur des variables.

Avertissement : Dans la plupart des formats pdfTeX, vous ne pouvez pas faire usage de ~ dans un nom de fichier que vous donnez directement à pdfTeX, parce que ~ est un caractère actif et, ainsi utilisé, ne peut être pris comme partie du nom de fichier. D’autres programmes, comme Metafont, n’ont pas ce problème.

TEXMFOUTPUT

Normalement, pdfTeX envoie ses fichiers de sortie dans le répertoire courant. Si aucun fichier de sortie ne peut être ouvert à cet endroit, il tente de l’ouvrir dans le répertoire spécifié dans la variable d’environement TEXMFOUTPUT. Il n’y a pas de valeur par défaut pour cette variable. Par exemple, si vous faites tex paper et que le répertoire courant n’est pas accessible en écriture, si TEXMFOUTPUT a la valeur /tmp, pdfTeX tente de créer /tmp/paper.log (et /tmp/paper.pdf, si une sortie est produite.)

TEXINPUTS

Le chemin de recherche pour les fichiers \input et \openin. Ceci devrait probablement être démarré avec « . », de façon à ce que les fichiers de l’utilisateur soient trouvés avant les fichiers système. Un constituant de chemin vide sera remplacé par les chemins définis dans le fichier texmf.cnf. Par exemple, régler TEXINPUTS sur « .:/home/usr/tex: » pour prérégler le répertoire courant et « /home/user/tex » sur le chemin de recherche standard.

TEXFONTS

Chemin de recherche pour les fichiers (.tfm) métriques.

TEXFORMATS

Chemin de recherche pour les fichiers de format.

TEXPOOL

Chemin de recherche pour les chaînes pdfinitex internes.

TEXEDIT

Modèle de commande pour basculer vers l’éditeur. Par défaut, c’est habituellement vi, qui est réglé lorsque pdfTeX est compilé.

La location des fichiers mentionés ci-dessous varie d’un système à l’autre. Utilisez l’utilitaire kpsewhich pour trouver leur emplacement.

pdftex.pool

Texte encodé des messages de pdfTeX.

texfonts.map

Définitions du mappage des noms de fichiers.

*.tfm

Fichiers métriques pour les fontes de pdfTeX.

*.fmt

Fichiers au format (.fmt) abrégé de pdfTeX.

Cette version de pdfTeX échoue à capturer le débordement arithmétique lorsque les dimensions sont ajoutées ou soustraites. Les cas sont rares, mais lorsque cela arrive le fichier DVI généré est invalide. Savoir si un fichier PDF généré pourrait être fonctionnel n’est pas documenté.

pdfTeX est un logiciel beta . Souscrivez à la mailing list de pdftex pdftex@tug.org si vous avez l’intention de l’utiliser. Il s’agit d’une liste gérée par majordomo ; pour souscrire envoyez un message contenant subscribe pdftex à majordomo@tug.org.

tex(1), mf(1), undump(1).

Les auteurs originels de pdfTeX sont Han The Thanh, Petr Sojka et Jiri Zlatuska. Traduction française - novembre 2001 - Jean-Pierre Delange<delange@imaginet.fr>