CTAN et documentation

Les packages, classes, polices et documentations du monde TeX sont réunis au même endroit : CTAN (Comprehensive TeX Archive Network). Deux compétences donnent accès à ses quelque 7000 packages : chercher dans CTAN et lire la documentation d’un package (avec texdoc).

CTAN

CTAN (ctan.org) est l’archive centrale de tout l’univers TeX : des milliers de packages, classes, polices et leurs documentations. Chaque page de package (ctan.org/pkg/<name>) indique la description, la version, le PDF de documentation, les dépendances et la licence (souvent LPPL). On peut chercher par nom ou par sujet/fonction. CTAN est un réseau maître + miroirs ; TeX Live et MiKTeX y récupèrent les packages, si bien qu’on installe normalement via tlmgr plutôt qu’en téléchargeant à la main. Les auteurs téléversent les nouveaux packages ou mises à jour vers le serveur maître, puis ceux-ci se propagent aux miroirs.

Documentation des packages — texdoc

Presque chaque package fournit un manuel détaillé. Ouvrez la copie locale avec texdoc PACKAGE (un PDF, hors ligne, correspondant à la version installée) et listez les candidats avec texdoc -l PACKAGE. Les mêmes documents sont consultables sur texdoc.org et sur chaque page de package CTAN. Quand une commande ou une option est ambiguë, le manuel du package est la réponse de référence.

terminal
texdoc booktabs      # 説明書を開く / open the manual
texdoc -l siunitx    # 候補を一覧 / list matches

Le flux de travail

  • Trouver par fonction → chercher dans CTAN par nom ou sujet ; vérifier le résumé, les dépendances et la licence sur la page du package.
  • Installertlmgr install (voir « Gestion des packages et des polices »).
  • Apprendre l’usagetexdoc PACKAGE (voir « texdoc / texfot … »).