Groff

Hum...! Hem...!

Comme Monsieur Jourdain fait de la prose, la plupart des nouveaux utilisateurs et utilisatrices de notre OS libre préféré utilisent un puissant outil de formatage et génération de documents. Outil qui a tendance à se faire oublier, tellement il est discrêt malgré sa participation vitale au quotidien de tout utilisateur ou utilisatrice, et cela concerne même les plus chevronné(e)s. --Mujma 20 nov 2005 à 12:03 (CET)

Que peut-on faire avec groff ?

La commande groff permet à partir d'une même source de :

• générer des documents mis en page : livre, lettre, documentation, rapport...etc.
• créer des images de ces documents en format : postscript, man (Latin 1 formatés), html, dvi, Textes (Latin1 formatés)...

Quelles sont ses origines ?

groff est d'origine 100% UNIX, au même titre que le shell. il se fait parfois appeler roff, nroff, troff, mais est toujours présent sur tout système de type UNIX. Il présente parfois de légères différences entre les différents UNIX, mais semble toujours compatible car ses développeurs ont prévu des équivalences. Même MINIX célèbre petit OS didactique développé par Andrew Tenenbaum (MINIX mais il fait le maximum...) dispose de cette commande !

Les forces et faiblesses de groff

Forces :

• Très rapide à assimiler comparé a son 'grand frêre' L^AT_EX.
• Grande robustesse et génération toujours fidèle aux attentes de l'utilisateur.
• Très léger, il permet un traitement rapide des informations même sur des petites configurations ne *disposant pas d'une interface X-Windows.
• Personnalisable

Faiblesses :(il en faut bien pour rester objectif)

• Son langage macro est un peu rébarbatif (mais après un petit effort, il devient vite familier).
• Un peut plus rigide que L^AT_EX losque l'on souhaite personnaliser un document.
• Peu de documentations sont disponibles étant donné son grand age.

Un exemple ! un example ! un exemple...

Comme mentionné précédemment, groff est présent sur votre ordinateur, et vous disposez déjà d'exemples sources ! Il vous suffit par exemple d'ouvrir un fichier de type man, pour cela, il vous suffit de choisir un petit exemple parmis les centaines de documentations man.

Comment procéder ?

[1.] Trouver l'emplacement des sources des fichiers de documentations du système. [2.] Copier une commande dans votre répertoire de travail habituel. [3.] Décompresser le fichier. [4.] Ouvrir le fichier dans votre éditeur de texte habituel. [5.] Contempler...

En pratique

Bien que je sois persuadé que la plupart d'entre-vous ont directement "switché" en mode console et sont déjà en train de tripatouiller un fichier juste pour voir, je vous donne ici les grandes directions qui vous permettrons de trouver ces fichiers.

Trouver les fichiers source man

Vous pouvez les chercher à la main, en changeant de répertoire. Généralement, on les trouve dans les parages de /usr/man ou encore /usr/share/man ou encore /usr/local/man et bien d'autres endroits.

<mujma@localhost>ls -l /usr/share/man total 300 drwxr-xr-x 4 root root 4096 aoû 17 20:12 bg drwxr-xr-x 2 root root 4096 aoû 17 20:26 cat1 drwxr-xr-x 2 root root 4096 aoû 17 20:26 cat5 drwxr-xr-x 5 root root 4096 aoû 17 20:12 cs drwxr-xr-x 4 root root 4096 aoû 17 20:12 da drwxr-xr-x 3 root root 4096 aoû 17 20:12 de drwxr-xr-x 5 root root 4096 aoû 17 20:12 el drwxr-xr-x 5 root root 4096 aoû 23 14:46 es drwxr-xr-x 3 root root 4096 aoû 17 20:10 et drwxr-xr-x 3 root root 4096 aoû 17 20:10 eu drwxr-xr-x 5 root root 4096 aoû 17 20:12 fi drwxr-xr-x 11 root man 4096 aoû 17 20:16 fr drwxr-xr-x 4 root root 4096 aoû 17 20:12 hr drwxr-xr-x 3 root root 4096 aoû 20 12:26 hu drwxr-xr-x 3 root root 4096 aoû 17 20:10 it drwxr-xr-x 4 root root 4096 aoû 17 20:12 ja drwxr-xr-x 4 root root 4096 aoû 17 20:12 ko drwxr-xr-x 2 root root 40960 nov 16 22:51 man1 drwxr-xr-x 2 root root 4096 jan 5 2004 man2 drwxr-xr-x 2 root root 114688 nov 8 08:47 man3 drwxr-xr-x 2 root root 4096 aoû 18 14:23 man4 drwxr-xr-x 2 root root 8192 nov 16 22:51 man5 drwxr-xr-x 2 root root 4096 aoû 17 20:20 man6 drwxr-xr-x 2 root root 4096 oct 20 18:20 man7 drwxr-xr-x 2 root root 12288 nov 2 15:07 man8 drwxr-xr-x 2 root root 4096 jan 5 2004 man9 drwxr-xr-x 2 root root 8192 aoû 17 20:29 mann drwxr-xr-x 5 root root 4096 aoû 17 20:12 nl drwxr-xr-x 4 root root 4096 aoû 17 20:32 pl drwxr-xr-x 4 root root 4096 aoû 17 20:12 pt drwxr-xr-x 5 root root 4096 aoû 17 20:12 ro drwxr-xr-x 3 root root 4096 aoû 17 20:10 ru drwxr-xr-x 4 root root 4096 aoû 17 20:12 sl drwxr-xr-x 3 root root 4096 aoû 17 20:10 uk