• [^] # 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é à 7.

    Le style des pdfs produits par utroff est très élégant mais peut-on facilement le changer ?

    Les deux commandes suivantes, qui appellent deux macros différentes (uh et us) mettent en forme un même document de deux façons différentes, ce qui est une façon de changer de style:

    troff -muh doc.tr | dpost | ps2pdf - > doc-uh.pdf
    troff -mus doc.tr | dpost | ps2pdf - > doc-us.pdf

    Si vous voulez de plus nombreux styles de mise en page pour ces mêmes document sources, vous n'aurez pas d'autres choix que de modifier les sources de l'une de ces macros. Je travaille en ce moment sur une macro pour les CV et les lettres, et je m'aperçois qu'en fait, il n'y a que quelques lignes à modifier pour produire une mise en page vraiment différente. Mais rien que pour cela, il faut néanmoins être un peu familier avec le langage Troff...

    Travaillez-vous avec les mainteneurs de doxygen, Sphinx, etc. pour que ces logiciels produisent une sortie utilisable par utroff ?

    Non, je ne travaille pas avec eux. Et effectivement, si j'ai un peu travaillé pour exporter les documents Utroff vers divers formats, pour l'instant je n'ai rien fait pour l'import.

    À vue de nez, il faudrait créer des filtres d'export vers le format d'Utroff pour Text2tags, reStructeredText, et Markdown pour couvrir la majorité des potentiels usages. Ça ne doit pas être bien compliqué.