Outils de polices et de bases de données

Ce ne sont pas des commandes du quotidien : ce sont des outils de maintenance qui gardent une installation TeX cohérente. updmap et kanji-config-updmap gèrent *les polices incorporées dans le PDF*, tandis que mktexlsr et fmtutil rafraîchissent les bases de données et les formats précompilés dont TeX dépend. On les utilise après avoir installé manuellement des polices ou des paquets, ou quand quelque chose « est introuvable ».

Les outils de maintenance réparent recherche, incorporation et démarrage

La maintenance de TeX devient beaucoup plus claire si l’on répartit les pannes en trois couches. Si un fichier installé n’est pas trouvé, soupçonnez la base de données des noms de fichiers. Si un PDF incorpore les mauvaises polices, soupçonnez les maps de polices. Si un moteur ne peut pas charger son .fmt au démarrage, soupçonnez les fichiers de format. mktexlsr, updmap et fmtutil réparent respectivement ces trois couches. Décidez quelle couche est cassée avant de tout lancer ; cela garde les machines partagées et les images CI prévisibles.

updmap — gérer les maps de polices

Les pilotes DVI (dvips, dvipdfmx) et pdftex apprennent, à partir d’une map de polices, la correspondance entre un nom de police TeX et le fichier de police réel, ainsi que la manière de l’incorporer. updmap régénère cette map combinée à partir des fichiers de map et des options activés ; on l’exécute après avoir activé la map d’une nouvelle police. updmap-sys agit sur la configuration système (droits administrateur requis) ; updmap agit sur la configuration de l’utilisateur et remplace celle du système.

Les réglages s’écrivent dans updmap.cfg avec --setoption KEY VALUE, et les maps s’ajoutent ou se retirent avec --enable Map foo.map / --disable. Lancer ensuite updmap (ou updmap-sys) applique les changements. La règle pratique est de ne pas mélanger réglages utilisateur et système. Sur les machines partagées ou en CI, standardisez sur updmap-sys ; réservez updmap seul aux essais personnels. Cela évite l’échec où « un seul auteur obtient des polices différentes ».

updmap-sys --enable Map myfont.map   # マップを有効化 / enable a map
updmap-sys                           # 合成マップを再生成 / regenerate the maps

kanji-config-updmap — choisir la police japonaise incorporée

La police incorporée pour le japonais (CJK) est décidée à l’étape dvi→pdf (dvipdfmx). L’outil simple pour la choisir est kanji-config-updmap (texjporg) : en interne, il règle l’option jaEmbed de updmap (anciennement kanjiEmbed), cherche les polices japonaises courantes et bascule entre elles. Utilisez status pour voir le réglage actuel, auto pour choisir automatiquement, ou passez un nom de famille (p. ex. ipaex, hiragino-pron, noto-otc) pour basculer vers celle-ci.

kanji-config-updmap-sys status   # 現在の和文フォントを表示 / show the current font
kanji-config-updmap-sys ipaex    # IPAex フォントを埋め込む設定に / embed IPAex

mktexlsr / texhash — rafraîchir la base des noms de fichiers

TeX utilise la bibliothèque kpathsea avec les bases de noms de fichiers ls-R pour localiser rapidement les fichiers dans les grands arbres texmf. Si vous déposez un fichier à la main dans un arbre texmf, TeX ne le verra pas tout seul. Reconstruire ls-R avec mktexlsr (alias texhash) rend les nouveaux fichiers trouvables.

mktexlsr        # ls-R を再構築（= texhash）/ rebuild ls-R (same as texhash)

fmtutil — reconstruire les formats

Des commandes comme pdflatex chargent au démarrage un fichier de format (.fmt, p. ex. latex.fmt). C’est un instantané complet de l’état du moteur juste après le chargement du format (LaTeX, par exemple), afin que le moteur puisse démarrer vite sans tout relire depuis zéro. fmtutil régénère ces fichiers .fmt. On l’utilise après un changement qui touche un format, ou lorsqu’un .fmt manque ou est corrompu et qu’une erreur « can’t find the format file » apparaît. fmtutil-sys agit sur les arbres système ; fmtutil --byfmt latex en reconstruit un seul, et fmtutil-sys --all les reconstruit tous. Ce n’est pas à lancer après chaque installation de paquet ; considérez-le comme un outil de maintenance pour les problèmes de démarrage du moteur.

fmtutil --byfmt pdflatex   # pdflatex の .fmt を作り直す / rebuild just pdflatex
fmtutil-sys --all          # すべてのフォーマットを再生成 / rebuild every format

Choisir la réparation dans l’ordre

• Si kpsewhich mypackage.sty ne trouve pas un fichier, vérifiez où il a été placé dans TEXMF et si mktexlsr est nécessaire.
• Si seules les polices japonaises du PDF sont incorrectes, inspectez d’abord le jaEmbed actuel avec kanji-config-updmap-sys status.
• Si une police occidentale nouvellement installée est incorrecte, vérifiez si sa .map a été activée avec updmap-sys --enable Map ....
• Si le moteur s’arrête avant le démarrage avec un message de format manquant, reconstruisez seulement ce format avec fmtutil --byfmt.

Quand en avez-vous besoin

• Police installée à la main → updmap (pour l’incorporation japonaise, kanji-config-updmap).
• Fichiers ou paquet déposés à la main dans texmf → mktexlsr (texhash).
• Changement lié aux formats / un .fmt est cassé → fmtutil.
• Normalement, le gestionnaire TeX Live tlmgr les appelle pour vous ; on ne les lance à la main que pour la maintenance.