• [^] # Re: Des styles ! Des systèmes de documentation automatique !

    Posté par (site web personnel) . En réponse à la dépêche Utroff : la renaissance de Troff. Évalué à 3.

    troff: fatal error: can't find macro file uh

    Aah, on entre dans le vif du sujet !

    Tu n'as probablement pas défini la variable d'environnement TROFFMACS, nécessaire à heirloom troff: export TROFFMACS='/usr/local/share/utroff/tmac/

    Il te faut aussi définir la variable d'environnement TROFFFONTS, pour y mettre le chemin vers la police libertine opentype (que tu auras préalablement installé): export TROFFFONTS='/path/to/libertine/dir/'

    Tu devrais aussi définir la variable UTMAC, pour charger une macro locale définissant ta langue:

    echo "so \\V[TROFFMACS]/u-fr" > ~/.utmac
export UTMAC='~/.utmac'

    La macro u-locale distribuée avec les macros utmac est un exemple un poil plus complexe de macro locale.

    Te disant cela, je m'aperçois que ces informations importantes mériteraient de remonter en haut du README, car il est vrai que si je les laisse en bas, tout le monde va passer à côté.

    less demo.tr | ugrind | refer | troff -muh ...

    Attention, car selon ce qu'il y a dans ton path, cette commande utiliseras gnu refer et gnu troff, et ça ne marchera pas. Indique les chemins absolus si tu as un doute, simplifie toi la vie en enlevant less, et n'oublie pas les options de la commande refer (ou définit la variable d'environnement REFER):

    /usr/local/bin/ugrind demo.tr \
| /usr/local/bin/refer -p biblio.ref \
| /opt/hlm/bin/troff -muh \
| /opt/hlm/bin/dpost \
| ps2pdf - > demo.pdf

    À l'avenir, tu pourras configurer ton installation aux petits oignons pour ne plus galérer avec le path.

    Jusqu'ici je m'en sors bien, mais je ne serais pas étonné qu'au prochain coup ce soit moi qui doive travailler ;)