Nouveautés

Les principales nouveautés sont résumées dans la documentation. La plus importante à mon avis est la possibilité d’intégrer des figures au format EPS directement en mode PDF, qui était un souhait récurent d’une grande partie des utilisateurs.

En plus des nouveautés citées dans la documentation, quelques paquets ont connu des mises à jour notables. Je pense par exemple à fontspec qui fonctionne désormais avec LuaLaTeX aussi bien qu’avec XeLaTeX. Par ailleurs, la gestion des motifs de césure sous LuaTeX a été améliorée, ce qui diminue considérablement le temps de chargement des formats basés sur LuaTeX, le rendant à nouveau comparable au temps de démarrage de pdfTeX.

Mise à jour

Comme l’année dernière, il n’est pas possible de mettre à jour TeX Live 2009 vers 2010, une ré-installation compète est nécessaire. Rappelons le bon côté de la chose : vous pouvez garder votre installation 2009 sous la main en cas de souci avec la nouvelle installation (documents ne compilant plus, par exemple).

Nous sommes conscients de la demande de nombreux utilisateurs de pouvoir mettre à jour d’une version majeure à la suivante et étudions cette possibilité pour la prochaine version.

Par ailleurs, TeX Live 2009, qui avait été gelée il y a quelques mois, n’est désormais plus disponible par les canaux de distribution habituelle. En particulier, si vous tentez une mise à jour avec tlmgr, vous obtiendrez un message d’erreur vous informant que la version du dépôt ne correspond pas à la version locale. En cas de besoin, toutes les versions passées de TeX Live restent disponibles.

Liste des changements

• Plusieurs problèmes de portabilité réglés, en particulier pour les compilateurs autres que gcc.
• Mise à jour de SyncTeX par Jérôme Laurens.
• Correction du bogue 406 : \pdfliteral gênait la césure.
• Correction d’un problème de surimpression en PDF (lié à \pdfliteral).
• Intégration d’un patch d’Akira Kakuto assurant que seules les commandes qui sont dans le PATH sont exécutées sous Windows en mode \write18 restreint.
• Correction d’un débordement de tampon dans luafontloader.
• Correction de problèmes de dépendance de la plate-forme pour les formats générés.
• Correction de coquilles dans la manuel.
• Correction d’un problème avec la glue (ressort) nulle écrasée par le code de référence des attributs.
• Documentation du caractère déprécié et cassé du traitement des otp.

Exécution restreinte de commandes

Une des nouveautés de TeX Live 2010 (précédemment prévue pour TeX Live 2009 mais reportée suite à plusieurs problèmes) est d’ajouter un nouveau niveau d’autorisation concernant l’exécution de commandes depuis TeX (souvent appelé \write18, du nom de la commande TeX le permettant) ; jusqu’ici les deux niveaux possibles étaient « tout est permis » ou « rien n’est permis ». Le nouveau mode, « restreint », a pour but d’autoriser seulement l’exécution de commandes (réputées inoffensives) appartenant à une liste fixée.

Cette fonctionnalité pose des problèmes délicats, par exemple le fait que, sous Windows, les commandes sont toujours recherchées en priorité dans le répertoire courant (quel que soit le réglage du PATH). Sachant que TeX peut écrire des fichiers arbitraires dans le répertoire courant, on imagine sans peine les possibilités d’attaque que cela ouvre. Plusieurs mesures sont prises pour éviter ces problèmes ; le patch mentionné ci-dessus n’est probablement pas propre à LuaTeX mais appartient sans doute à une série concernant d’autres exécutables de TeX Live.

Formats et boutisme

Les jeux de macros comme LaTeX, plutôt que d’être lus et interprétés par *TeX (lire : TeX ou pdfTeX ou XeTeX ou LuaTeX ou …) à chaque démarrage, sont traités une bonne fois pour tout et stockés sur le disque sous forme de fichiers .fmt : les formats. Ces fichiers formats constituent une image de la mémoire de *TeX, et sont donc très rapides à charger au démarrage.

Cependant, l’état précis de la mémoire de *TeX dépend de paramètres comme le boutisme du processeur (les octets de poids fort sont-ils au début où à la fin). Des précautions particulières sont prises à la création du fichier format et à son chargement pour inverser si nécessaire l’ordre des octets, de sorte que le fichier format soit indépendant du boutisme ambiant, ce qui facilite grandement la gestion d’installations TeX partagées entre des machines de boutisme différent.

Cette question concerne toutes les variantes de TeX et est en général réglée depuis longtemps. Cependant, LuaTeX pose des problèmes nouveaux en ce domaine, par exemple à cause de la possibilité de stocker du code Lua dans le format : par défaut le bytecode généré par Lua n’est pas indépendant de la plateforme, et l’équipe LuaTeX a du l’adapter pour obtenir la propriété voulue. Un problème de ce type vient donc encore d’être corrigé.

Héritage d’Omega

LuaTeX admet plusieurs parents directs, dont le plus connu est pdfTeX, mais un autre parent non moins important est Aleph (le successeur d’Omega), qui permettait déjà une bonne gestion d’Unicode, et proposait une gestion des écritures multi-directionnelles qui a été reprise par LuaTeX (de préférence à celle d’e-TeX, présente aussi dans pdfTeX).

En première approximation et à l’origine, LuaTeX formait un sur-ensemble d’Aleph (et d’Omega) et incluait ainsi tous les mécanismes développés par Omega. L’un de ces mécanismes, OTP (Omega Translation Process) avait pour but de permettre une conversion automatique entre codages de caractères, et plus généralement des manipulations sur les flux de caractères entrant et sortant d’Omega. LuaTeX propose de meilleures solutions à ces problèmes, avec ses différents callback Lua.

Le traitement des OTP est désormais officiellement déprécié, après avoir été cassé depuis quelque temps déjà. Ce cas me semble représentatif de plusieurs fonctionnalités héritées d’Omega, parmi lesquelles aucun ménage systématique n’a encore été fait mais qui sont peu ou pas testées du fait de l’existence de meilleurs solutions dans LuaTeX, et sont donc souvent cassées (parfois, elles l’étaient déjà dans Omega, mais c’est une autre histoire) et appelées à progressivement disparaître.

Avertissement préliminaire

Les versions de test ne sont par définition pas stables. Même si une version semble fonctionner à un moment donné, rien ne dit que le lendemain elle ne va pas insérer des fautes dans vos énoncés mathématiques, détruire les sauvegardes de vos documents importants ou pire, finir votre réserve de chocolat. Ces versions de test sont destinées aux utilisateurs avertis qui disposent en parallèle d’une installation stable de TeX Live, et n’ont pas pour but de vous fournir la prochaine version avec quelques semaines d’avance.

Les innombrables bugs que vous ne manquerez pas de rencontrer sont à rapporter sur la liste TeX Live : tex-live(arobase)tug(point)org. Les bugs spécifiques à des paquets sont par contre à reporter aux auteurs des paquets en question (éventuellement après avoir été discutés sur fr.comp.text.tex, la liste gut, ou votre forum LaTeX préféré pour s’assurer qu’il s’agit bien de bugs).

N’hésitez pas à (re-)compiler autant de documents que possible avec cette nouvelle version, et à la torturer de toutes la façons que vous pourrez imaginer. Merci d’avance !

Téléchargement, installation et mises à jour

Les versions de test ne sont pas distribuées par le réseau de miroirs habituel du CTAN. Elles sont disponibles sur des sites spécifiques, dont voici la liste. Pour installer TeX Live depuis ces emplacements, plusieurs méthodes sont disponibles :

• si vous souhaitez tester la variante MacTeX, téléchargez une des archives mactex-<date>.zip (n’utilisez mactex64 que si votre machine est effectivement en 64 bits) puis procédez comme d’habitude.
• sinon, télécharger l’archive install-tl.zip depuis le miroir, la décompresser dans le répertoire de votre choix, puis lancer install-tl -repository <url-du-mirroir> (ou install-tl.bat sous Windows) et poursuivre comme d’habitude.

Si vous prévoyez de faire plusieurs installations avec cette deuxième méthode, il est plus économique en bande passante de maintenir une copie local du dépôt, par exemple avec rsync :

rsync -avz --delete --exclude='mactex*' rsync://$mirror/tlpretest/ pretest

Il convient alors d’invoquer install-tl sans l’option -repository afin qu’il utilise le répertoire courant comme source.

Après installation, il est recommandé de régler tlmgr pour utiliser un des dépôts en question par défaut. Par exemple, en ligne de commande :

tlmgr option repository <url>

La plupart du temps, les mises à jour devraient fonctionner, mais il n’est pas impossible que de temps à autres vous deviez faire une ré-installation complète.

Changement notables

Je parlerai plus en détail des nouveautés de TeX Live 2010 dans un prochain billet ; les plus impatients et anglophones d’entre vous peuvent lire la fin de la page de TeX Live 2010-pretest en attendant.

Il est théoriquement possible d’adapter notre infrastructure de gestion des mises à jour pour produire à la fois des paquets pour l’ancienne version et des paquets de pré-test pour la nouvelle version, mais nous n’avons pas eu (ou pris) le temps de travailler à un tel dispositif pour le moment. Peut-être l’année prochaine. En attendant, les amateurs de nouveautés pourront prochainement tester des pré-versions de TeX Live 2010.

Notons que ce gel ne signifie pas que les versions des paquets présentes dans TeX Live sont figées à partir d’aujourd’hui. Au contraire, les mises à jour depuis le CTAN continuent comme d’habitude, mais ne sont simplement plus propagées jusqu’au dépôt de paquets en ligne. Un gel des paquets interviendra plus tard, au moment de construire les images finales du DVD juste avant la sortie officielle de TeX Live 2010.

Pour le moment, nous ne savons pas encore s’il sera possible de mettre à jour depuis TeX Live 2009 vers TeX Live 2010. La question est à l’étude, mais s’il apparaît qu’un tel mécanisme serait trop complexe ou pas assez fiable, il ne sera pas proposé et il faudra, comme les années précédentes, installer la nouvelle version de TeX Live à partir de zéro.

Fichiers de configuration

Pour indiquer à texdoc vos visualisateur favoris, il suffit d’insérer quelques lignes dans votre fichier de configuration texdoc personnel. Pour trouver celui-ci, lancez texdoc -f et repérez le fichier indiqué par une étoile. Il est probable que ce fichier et le répertoire qui doit le contenir n’existent pas encore, il vous faudra alors les créer.

Texdoc utilise simultanément plusieurs fichiers de configuration : en général, l’un est livré avec TeX Live, un autre est destiné à l’administrateur de la machine, et un dernier est réservé à votre usage personnel. (Quelques autres fichiers peuvent être utilisés dans des cas particuliers, comme une installation partagée entre plusieurs machines, ou pour utiliser la version de développement de texdoc.) De plus, la liste exacte peut dépendre de la version de texdoc utilisée (par exemple, dans des paquets Debian, les emplacements des fichiers voire leur nombre peut être modifiée). L’option -f a pour but de vous aider à vous retrouver parmi cette jungle de fichiers.

Directives de configuration

À chaque type de fichier correspond une variable de configuration : par exemple, pour les pdf, c’est viewer_pdf. Les valeurs de ces variables se règlent ainsi, une par ligne :

viewer_pdf = xpdf %s &
viewer_txt = view

Les espaces autour du signe égal ne comptent pas. Le signe %s représente le nom du fichier à visualiser ; on peut l’omettre lorsque c’est le dernier élément de la ligne. Dans le premier cas, observez l’usage de & pour lancer le visualisateur en arrière-plan (syntaxe shell standard).

Pour les curieux : méthode de choix par défaut

Sous Windows et Mac OS X, pour ce genre de choses, la vie est plus facile. En effet, il existe des associations entre types de fichiers et visualisateurs, définies au niveau global, et il est facile d’ouvrir un fichier en utilisant ces associations (commande open sous OS X et start sous Windows). C’est donc ce que fait texdoc, sauf pour les fichiers de type texte. En effet, ceux-ci sont parfois dépourvus d’extension, donc texdoc force l’utilisation d’un pager par souci d’uniformité (more sous Windows, less sous OS X).

Sous un Unix général, les choses se corsent. Des environnements de bureau comme KDE, Gnome, ou encore XFCE, définissent aussi des associations et des commandes pour ouvrir les fichiers en utilisant ces associations. Cependant, il serait faut de croire que parce que gnome-open existe, l’utilisateur est effectivement sous Gnome. Il faut donc détecter la présence d’un environnement de bureau de façon adaptée : pour cela, texdoc utilise désormais une technique largement inspirée de xdg-open, du projet XdgUtils.

Si aucun environnement de bureau n’est détecté, texdoc explore le PATH à la recherche de visualisateurs connus parmi une liste embarquée dans le code. L’ordre de cette liste n’a alors plus aucune raison de refléter les goûts d’un utilisateur particulier, mais il faut bien choisir…

Par ailleurs, certaines distributions, dans leur paquet texdoc, modifient le lecteur par défaut pour utiliser un outil spécifique à la distribution, comme la commande see sous Debian et dérivés.

Historique

Jusqu’à TeX Live 2007, la seule façon de configurer les visualisateurs était d’utiliser des variables d’environnements comme TEXDOCVIEW_pdf. Cette méthode est toujours acceptée même si les fichiers de configuration sont désormais la méthode recommandée. Par ailleurs, en l’absence de configuration explicite, le nom du lecteur était codé en dur, sans alternative. Depuis TeX Live 2008, plusieurs lecteurs sont essayé dans ce cas ; leur liste a évolué depuis, et le mécanisme de détection des environnements de bureau n’est apparu qu’après TeX Live 2009.

Recherche via texdoc depuis texdoctk

J’ai dernièrement rajouté à texdoctk un deuxième bouton de recherche, qui utilise texdoc. Désormais, il y a donc deux modes de recherches sous texdoctk : database search, la méthode traditionnelle de texdoctk, et file search, qui utilise texdoc (les noms ne sont sans doute pas très explicites, je suis ouvert à toute suggestion). J’espère qu’ainsi :

• les utilisateurs qui ne connaissent pas texdoc mais qui ont remarqué l’icône TeXdoc GUI sur leur bureau (sous windows) pourront ainsi découvrir cet outil plus facilement. Même sans comprendre la différence exacte entre les deux boutons de recherche, j’espère qu’ils auront réflexe d’essayer les deux, et verront rapidement lequel leur convient mieux.
• les quelques utilisateurs allergiques à la ligne de commande disposeront d’un moyen d’accès à la documentation moins effrayant.

Choix du visualisateur

Par ailleurs, les configurations de texdoc et de texdoctk étaient pour l’instant totalement indépendantes, notamment en matière de choix du visualisateur selon le type de document. Ceci n’était pas très satisfaisant dans le sens où, si l’on utilise les deux régulièrement, il fallait indiquer son lecteur de de PDF favori dans deux fichiers de configurations totalement indépendants.

Comme par ailleurs la façon dont texdoc choisit le visualisateur en l’absence de choix explicite de l’utilisateur me paraît meilleure que celle que texdoctk, j’ai donc modifié le réglage par défaut de texdoctk pour utiliser la commande texdoc --just-view qui a pour effet d’ouvrir le fichier avec le lecteur que texdoc aurait choisi (via sa configuration ou ses heuristiques). Ainsi, par défaut, la configuration s’effectue en un lieu unique, même s’il reste possible de choisir des visualisateurs différents pour texdoctk.

L’avenir

À mes yeux, texdoctk présente plusieurs points intéressants : navigation par catégories, recherche par mot-clé, interface graphique. Néanmoins, il souffre aussi de plusieurs inconvénients : il utilise une base de donnés qui lui est propre et son interface n’est à mon goût pas très jolie (je ne suis pas un grand fan de Tk), ce qui fait perdre un peu le côté rassurant d’une interface graphique pour certain utilisateurs.

Le gros problème de la base de données spécifique est qu’elle n’a jamais été exhaustive et n’est plus maintenue depuis longtemps, ce qui n’est pas surprenant car c’est une tâche qui demanderait un gros travail. Or ce travail est déjà effectué, avec brio, par l’équipe du CTAN qui fournit un catalogue exhaustif et à jour, ainsi qu’une classification par sujets, peut-être pas encore exhaustive mais en tout cas bien plus à jour que la base de texdoctk. Il serait souhaitable que texdoctk ou son successeur puisse utiliser directement ces informations plutôt que de dupliquer le travail.

Dans une prochaine vie (c’est-à-dire une fois ma thèse terminée, car j’espère bien qu’il y a une vie après), je prévois de travailler sur un nouvel outil regroupant les avantages de texdoc, ceux de texdoctk (modifiés pour utiliser directement le catalogue), et peut-être d’autres (recherche dans la FAQ, etc.) avec une interface graphique un peu plus sexy j’espère. En attendant, vos suggestions sont les bienvenues pour étoffer ma liste pour ce projet.

Des exécutables seront bientôt disponibles sur la page téléchargements du projet, et j’ai précédemment expliqué comment installer une version récente de LuaTeX sur TeX Live, pour ceux qui veulent l’essayer sans attendre.

Nouvelles fonctionnalités

• os.name prend maintenant en compte CYGWIN (par Élie Roux).
• La gestion interne des spécifications de direction est plus rapide maintenant.
• Chaque nœud de glyphe a maintenant trois champs virtuels en lecture seule : width, height, et depth (les valeurs sont en sp (points d’échelle) bien sûr).
• Il y a de nouvelles fonctions node.protrusion_skipable() et tex.badness() (utiles pour le découpage des paragraphes en Lua).
• Également nouveau : tex.linebreak(). Voir le manuel pour les détails.
• Toutes les erreurs en Lua indiquent maintenant le fichier et le numéro de ligne pour aider à déboguer.
• Import de Metapost 1.211.
• pdf.pdfcatalog sera bientôt remplacé par le nouveau pdf.catalog ; pdf.pdfinfo sera bientôt remplacé par le nouveau pdf.info ; pdf.pdfnames sera bientôt remplacé par le nouveau pdf.names ; pdf.pdftrailer sera bientôt remplacé par le nouveau pdf.trailer.
• pdf.pdfmapfile et pdf.pdfmapline sont remplacés pas les nouvelles fonctions pdf.mapfile() et pdf.mapline() (une fonction convient mieux comme interface pour ces paramètres vu qu’il ne retournent jamais rien).
• Nouvelles variables Lua en lecture et écriture : pdf.pagesattributes, pdf.pageresources, pdf.pagesresources.
• getluatexsvnversion.sh détecte maintenant correctement git-svn et arrive encore à trouver un numéro de révision SVN valide (de Patrick Gundlacj).
• Plusieurs fichiers sources ont été convertis en CWEB.

Corrections de bogues

• GNU libtool est maintenant utilisé pour résoudre les problèmes techniques variés liés au chargement dynamique de modules Lua.
• La détection des erreurs dans scan_interger_part était incorrecte car OK_so_far n’était pas initialisée (remarqué par Javier Mugica).
• Synctex était cassé dans 0.51 et 0.52.
• \lastlinefit était cassé depuis… euh, à peu près toujours.
• La lecture des fichiers binaires de taille nulle était cassée.
• Détection des réglures non initialisées (pour les nœuds de réglures créés de travers depuis Lua).
• pdfimmediatobj('streamfile') était cassé sur les plate-formes 64 bits.
• tex.linebreak ne prenait pas les valeurs de ressort droit et gauche données, mais utilisait en fait les valeurs courantes coté TeX (bug #356).
• La commande make de build.sh est maintenant passée à configure pour résoudre les problèmes où GNU make n’était pas trouvé alors qu’il était effectivement installé.
• dofile(<nil>) et loadfile(<nil>) en batchmode provoquent maintenant une erreur et continuent plutôt que d’attendre inutilement une entrée de l’utilisateur.
• Annulé le commit numéro 3417 (l’expérience avec buildpage) car il provoque des problèmes quand des items sont en attente au moment du saut de page.
• loaders[4] est écrasé en mode --safer; require() se comporte de façon plus semblable au Lua 5.1 normal ; meilleurs messages d’erreur (d’après un e-mail et des patchs de Manuel Pégourié-Gonnard).
• Test supplémentaire au chargement GDEF dans luafontloader, basé sur un crash causé par la fonte AkaashNormal.ttf de Linux.

Les modes

Par défaut, quand vous tapez texdoc live, texdoc ouvre dans un lecteur qu’il juge approprié le résultat qu’il juge le plus pertinent ; c’est le mode view, le plus adapté pour consulter rapidement un document quand vous savez bien ce que vous voulez.

Il est possible néanmoins que plusieurs documents soient intéressants pour un mot-clé donné et que vous vouliez tous les examiner ; ou bien, texdoc peut s’être trompé dans son estimation de pertinence et ne pas vous présenter le meilleur résultat en mode view. Dans ce cas, vous pouvez utiliser le mode list pour que texdoc vous présente la liste des documents trouvés et vous permette de choisir lequel afficher.

mpg@roth:~% texdoc -l xargs
 1 /home/mpg/tl/trunk/Master/texmf-dist/doc/latex/xargs/xargs.pdf
   = [en] Package documentation (English)
 2 /home/mpg/tl/trunk/Master/texmf-dist/doc/latex/xargs/xargs-fr.pdf
   = [fr] Package documentation (French)
Please enter the number of the file to view, anything else to skip: 2

Par ailleurs, vous pouvez avoir le meilleur de ces deux modes : s’il n’y qu’un seul résultat, l’ouvrir directement pour gagner du temps, sinon, afficher la liste et vous laisser choisir ; c’est le mode mixed.

Un dernier mode, showall, force texdoc à afficher aussi des résultats qu’il juge probablement mauvais (ce qu’il fait automatiquement s’il ne trouve aucun « bon » résultat). À l’heure actuelle, je ne connais pas de cas où il est utile.

Par défaut, quand texdoc vous présente une liste, il vous demande de choisir un résultat à afficher ; de plus, si les résultats sont trop nombreux, il vous demande une confirmation avant d’en afficher la liste. Si vous n’aimez pas qu’on vous pose des questions, il est possible de désactiver toute interaction.

Sélection en ligne de commande

Il est possible de sélectionner le mode à l’aide d’options au nom explicite : --view (-w), --list, (-l), --mixed, (-m), --showall (-s). De plus, vous pouvez désactiver toute interaction avec --nointeract (-I) ou au contraire l’activer avec --interact (-i).

Sélection par le fichier de configuration

Si le mode par défaut n’est pas votre mode préféré, il est fastidieux d’avoir à saisir l’option correspondante à chaque fois. Il est plus pratique de configurer celui-ci une fois pour toute dans un fichier de configuration. Pour connaître le nom et l’emplacement du fichier à utiliser, exécutez texdoc --files et regardez la ligne indiquée par une étoile. Il faudra probablement créer ce fichier et le répertoire.

Vous pouvez alors indiquer votre mode préféré en insérant une ligne mode = nom-du-mode, activer ou non les interaction avec interact_switch = true-ou-false. Par exemple,

mode = list
interact_switch = false

pour que texdoc vous présente par défaut la liste des résultats en mode non interactif.

Historique

Le mode mixed est apparu dans texdoc 0.4 (TeX Live 2008). C’est aussi à ce moment que le mode list est devenu un menu permettant de choisir le document à afficher, et que sont apparues les possibilités de désactiver cette fonctionnalité et de configurer le mode par défaut via un fichier de configuration.

Depuis, la signification des modes a légèrement changé au fur et à mesure que les mécanismes de recherche de texdoc ont évolué. Avant la version 0.6, le mode showall s’appelait search ; avant 0.4 il signifiait que la recherche s’effectuait directement sur le disque (sans utiliser d’index) et que l’argument était interprété comme une expression régulière. Ce sens a subsisté un moment sous la forme du mode regex, aujourd’hui déprécié et qui devrait disparaître dans une prochaine version de texdoc.

Avant d’aller plus loin, notons que pour rechercher des informations sur LaTeX, google (ou tout autre moteur de recherche) n’est pas forcément votre ami. Certes, le web regorge de fils de discussion sur LaTeX, de FAQ, de pages de trucs et astuces, mais la qualité de ces ressources est très variable, en particulier parce qu’elles datent parfois du siècle dernier.

La documentation spécifique d’un module, en revanche, est écrite et mise à jour par l’auteur du module lui-même. Sans me lancer dans une grande tirade concernant la qualité de l’information sur le web, j’aimerais souligner qu’il me paraît utile (et pas seulement dans le monde de LaTeX) de savoir identifier la source d’information faisant autorité et de prendre l’habitude de s’y référer ; les autres sources d’information ont bien sûr leur intérêt mais constituent à mon avis un complément plutôt qu’un substitut à la documentation originale.

En ligne

Tous les modules présents dans les distributions modernes (TeX Live et MikTeX) proviennent du CTAN, le Comprehensive TeX archive network, qui accueille, outre les modules, leur documentation au format PDF (et leur source).

Pour y accéder, le moyen le plus commode est sans doute d’utiliser l’URL « magique » http://ctan.org/pkg/nom-du-module. Par exemple, si l’on cherche des renseignements sur biblatex, on peut visiter http://ctan.org/pkg/biblatex. En dessous de la description, on trouvera un champ « Documentation on CTAN » avec des liens vers les principaux documents décrivant le module.

Si l’on ne connaît pas précisément le nom du paquet sur le CTAN (qui n’est pas forcément le même que le nom du module LaTeX), on peut essayer la page de recherche du CTAN.

En local

L’inconvénient d’accéder à la documentation sur le web, c’est qu’on a pas toujours accès au réseau au moment où l’on travaille (par exemple dans le train). Heureusement, les distributions TeX en installent une copie sur votre disque dur. Même quand vous avez accès au réseau, cette version est souvent plus rapide à consulter. Des outils sont disponibles pour vous aider à localiser le document cherché.

Sous MikTeX, l’outil privilégié s’appelle mthelp. Il s’utilise en ligne de commande (faire Window-R puis taper cmd pour obtenir une invite de commande sous Windows), en tapant mthelp nom-du-module. Selon les cas, il ouvre directement la documentation dans votre lecteur PDF, ou bien crée une liste de liens vers les documents potentiellement intéressants, et charge ces liens dans votre navigateur.

Sous TeX Live, on utilise texdoc, également en ligne de commande. L’utilisation de base est la même : texdoc nom-du-module. Par contre, ceci ouvre toujours le document correspondant ; on peut aussi obtenir une liste de résultats en tapant texdoc -l nom-du_module à la place, et ensuite choisir le document à ouvrir depuis la liste. Sous MacTeX, TeX Live utility propose (entre autres) une interface graphique pour utiliser texdoc.

TeX Live inclus aussi un outil graphique de recherche de documentation, texdoctk. Celui-ci propose une navigation par catégorie, et un mode de recherche. Attention, le recherche ne s’effectue pas dans l’ensemble de la documentation, uniquement dans le catalogue de texdoctk (mise à jour : il y a désormais deux modes de recherche). Notons que texdoctk n’est pas maintenu (je m’assure régulièrement que la base de données ne recense que des fichiers qui existent, mais c’est tout). Par ailleurs, malgré la similarité des noms, texdoc et texdoctk n’ont en fait aucun rapport.

Depuis 2008, j’ai repris le développement de texdoc. Cet article est le premier d’une série dans laquelle je présenterai ses principales fonctionnalités, quelques réflexions sur son évolution, et des plans pour la suite du développement.

Depuis la précédente version française, le chapitre sur les math a considérablement évolué, ce qui est heureux car la composition des maths est souvent la raison qui pousse à essayer LaTeX. Par ailleurs, des sections sur le PDF et l’utilisation d’hyperref ont été ajoutées. Pour la petite histoire, ce matériel avait été d’abord écrit par Daniel Flipo pour un numéro hors-série des Cahiers GUTenberg.

Nous avons l’intention de continuer à tenir à jour régulièrement la version française. Notre travail est distribué sous licence GPL, et la dernière version des sources ainsi que l’historique sont disponibles sur github : ici et là (attention, la branche master représente la version originale).

Au cours du travail de traduction, des erreurs ou coquilles nous ont vraisemblablement échappé : n’hésitez pas à nous les signaler, ou à nous suggérer des améliorations. Les suggestions qui ne sont pas spécifiques à la traduction peuvent aussi être adressées à l’auteur, Tobias Oetiker.

Un grand merci à Matthieu Herrb pour avoir effectué la première traduction et assuré sa maintenance jusqu’à la version 3.20 !