texdoc / texfot / Ghostscript / dvisvgm

Au-delà de la compilation, une installation TeX fournit de petits utilitaires qui facilitent le travail quotidien : texdoc pour ouvrir le manuel d’un paquet, texfot pour réduire la sortie de compilation aux messages importants, Ghostscript pour créer ou alléger des PDF, et dvisvgm pour transformer la sortie en SVG prêt pour le Web. Cette page sert de mémo pour ces quatre outils.

Placer les quatre outils dans le flux de rédaction

L’objectif de ce chapitre n’est pas de mémoriser quatre commandes, mais de savoir quel outil utiliser à chaque étape de la rédaction d’un document. Avant d’ajouter un paquet, lisez son manuel avec texdoc. Quand la sortie de compilation devient trop bavarde, utilisez texfot pour faire ressortir les avertissements. Si un PDF de soumission est trop volumineux, compressez-le avec Ghostscript, puis vérifiez les liens et les polices incorporées. Pour des formules ou des diagrammes destinés au Web, exportez en SVG avec dvisvgm et inspectez le résultat dans un navigateur avec un fort zoom. Utilisés dans cet ordre, recherche, rédaction, finition et publication forment un même flux.

texdoc — ouvrir le manuel d’un paquet

La plupart des paquets CTAN sont fournis avec un manuel détaillé (un PDF), qui est déjà sur votre machine après l’installation. Tapez texdoc PACKAGE : il trouve ce manuel et l’ouvre dans un visualiseur, hors ligne et dans la version correspondant à celle que vous avez réellement installée. L’outil est fourni avec TeX Live (à l’origine par Manuel Pégourié-Gonnard) ; la même base de données peut aussi être consultée sur texdoc.org.

texdoc booktabs      # booktabs の説明書を開く / open booktabs’ manual
texdoc -l siunitx    # 候補を一覧表示（開かない）/ list matches instead of opening

Par défaut, il ouvre le meilleur résultat unique. -l (--list) affiche une liste de candidats à choisir au lieu d’en ouvrir un. -s (--showall) élargit les résultats pour inclure aussi les correspondances moins bien classées. Lorsque vous ajoutez un paquet à un rapport ou à un chapitre de thèse, utilisez d’abord texdoc PACKAGE pour repérer la commande de chargement, l’exemple de référence et les options importantes ; copiez ensuite seulement le minimum nécessaire dans le préambule. Cela évite une configuration qui s’étale.

texfot — seulement les messages importants

Une exécution TeX produit un flot de messages, et les avertissements ou erreurs dont vous avez réellement besoin peuvent défiler sans être vus. texfot (un script Perl du domaine public écrit par Karl Berry) lance le moteur et filtre le journal pour ne garder que les lignes « intéressantes » : erreurs, avertissements, boîtes overfull/underfull, etc. Il transmet le code de sortie tel quel, donc il ne perturbe pas le test de réussite d’un outil de build.

texfot pdflatex document.tex     # 出力を要約しつつコンパイル / compile with a quiet, filtered log

Pour l’utiliser avec latexmk, enveloppez l’appel au moteur avec texfot dans votre fichier de configuration :

# .latexmkrc
$pdflatex = 'texfot pdflatex %O %S';

Ghostscript — créer et réduire des PDF

gs (Ghostscript) est l’interpréteur PostScript/PDF ; c’est aussi ce que ps2pdf exécute en interne. Avec -sDEVICE=pdfwrite, il écrit du PDF, ce qui permet de convertir du PS en PDF, de fusionner plusieurs PDF et de compresser un PDF trop volumineux (en sous-échantillonnant ses images). La qualité se choisit avec un préréglage -dPDFSETTINGS comme /screen (contrôle à l’écran), /ebook (moyen), /printer (orienté impression) ou /prepress (orienté prépresse). Ces préréglages reconstruisent le PDF et peuvent modifier l’entrée. Pour une soumission ou une livraison à l’impression, vérifiez toujours la lisibilité des images, les polices incorporées, les liens et la taille des pages après compression.

gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dNOPAUSE -dBATCH \
   -sOutputFile=small.pdf big.pdf

dvisvgm — DVI vers SVG

dvisvgm (par Martin Gieseking) convertit le DVI en SVG (graphisme vectoriel). Il accepte aussi EPS, ainsi que l’entrée PDF avec --pdf. Il est idéal lorsque vous voulez publier sur le Web des formules ou des diagrammes qui restent nets à tout niveau de zoom. Les polices sont incorporées en SVG par défaut, mais --font-format=woff2 (ou woff, ttf) permet de passer à des formats de polices Web. Avec une entrée PDF, selon le chemin de traitement, le texte peut devenir des tracés au lieu de polices incorporées ; décidez donc si vous convertissez depuis DVI ou depuis PDF, puis vérifiez le rendu réel dans un navigateur. Utilisez -p (--page) pour sélectionner les pages.

latex equation.tex                       # → equation.dvi
dvisvgm --font-format=woff2 equation.dvi # → equation.svg
dvisvgm --pdf figure.pdf                 # PDF を入力にする / convert a PDF

Diagnostiquer les échecs courants

• Si texdoc ouvre le mauvais manuel, lancez texdoc -l PACKAGE, examinez les candidats et choisissez le PDF voulu par son numéro.
• Si texfot n’affiche rien mais que le PDF semble toujours incorrect, retirez temporairement texfot et lisez le journal brut pour vérifier si un contexte utile a été filtré.
• Si des liens ou des signets disparaissent après une compression avec Ghostscript, la reconstruction du PDF a peut-être supprimé des informations non visibles. Comparez le PDF original et le PDF compressé avant la soumission.
• Si dvisvgm --pdf transforme le texte en tracés, le SVG ne conservera pas de texte recherchable ou remplaçable. Pour des figures Web modifiables, essayez d’abord une conversion depuis DVI.

Quand utiliser chaque outil

• Consulter le fonctionnement d’un paquet → texdoc PACKAGE.
• Rendre un journal moins bavard → texfot (avec latexmk).
• Un PDF est trop gros / convertir PS en PDF → Ghostscript (-dPDFSETTINGS).
• Mettre des formules ou figures sur le Web en SVG → dvisvgm.