Groff signifie GNU troff. Groff est généralement utilisé pour créer des pages de manuel. Mais, il fait plus que cela. C'est un utilitaire de la vieille école qui existe depuis près de 20 ans mais qui est toujours présent.
En tant que moteur de formatage et de composition, cet utilitaire agit comme un compilateur pour l'entrée fournie (contenu en texte brut et formatage commandes) et il crée un document formaté en sortie. Dans cet article, nous comprendrons les bases de cette commande en discutant de certaines requêtes groff courantes avec des exemples.
Voici la syntaxe de cette commande :
groff [-abcegiklpstzCEGNRSUVXZ] [-d cs] [-D arg] [-f fam] [-F répertoire] [-I répertoire] [-K arg] [-L arg] [-m nom] [-M répertoire] [-n num]
[-o liste] [-P arg] [-r cn] [-T dev] [-w nom] [-W nom] [fichier …]
groff -h | –help
groff -v | –version [choix …]
1. Exemple de base de Groff
Cet exemple utilise l'utilitaire groff pour créer un document avec une seule ligne sans aucune mise en forme.
$ groff > grof_output_1 Hi, this is a Line.
Cette commande produirait un fichier PostScript (fichier PS) qui peut être ouvert dans une visionneuse de documents.
2. Introduire l'interligne à l'aide de la commande .sp
Si un interligne doit être introduit, utilisez la commande .sp suivie du nombre d'interlignes requis.
$ groff > grof_output_2 .sp 10 This line will occur after 10 spaces. Thanks.
3. Demander une pause à l'aide de la commande .br
Pour un saut de ligne régulier, utilisez la commande .br comme indiqué ci-dessous.
$ groff > grof_output_3 Hi, .br Welcome to TGS!
4. Modifier l'espacement des lignes à l'aide de la commande .ls
L'interligne d'un document peut être modifié à l'aide de la commande .ls suivie du nombre d'interlignes à introduire. Par défaut, l'interligne est de 1.
$ groff > grof_output_4 .ls 2 Hi, .br Welcome to TGS!
Ce document ressemblera à ce qui suit lorsqu'il sera affiché dans une visionneuse de documents :
5. Introduisez une page de saut à l'aide de la commande .bp
S'il est prévu d'avoir la ligne ou le paragraphe suivant de la page suivante du document, la commande .bp est utilisée.
$ groff > grof_output_5 Hi, .bp Welcome to TGS!
6. Lignes centrales à l'aide de la commande .ce
Si certaines lignes doivent être poussées vers le centre du document, la commande .ce peut être utilisée.
L'argument de .ce détermine combien de lignes doivent être poussées au centre.
$ groff > grof_output_6 .ce 1 TGS DOCUMENT Hello and welcome to TGS.
7. Définir l'indentation à l'aide de la commande .in
Si l'indentation doit être modifiée, cela peut être fait via la commande .in suivie de l'index d'indentation.
$ groff > grof_output_7 Hi, .br .in 4 Welcome to TGS!
Ce document ressemblera à ce qui suit lorsqu'il sera affiché dans une visionneuse de documents :
8. Combinez .br et .ce en utilisant .ti
Cette commande peut être utilisée pour casser le texte et centrer la ligne suivante immédiate sur "n" étapes. Où 'n' est l'argument passé à la commande .ti.
$ groff > grof_output_8 Hi, .ti 5 Welcome to TGS!
9. Définir le décalage de page à l'aide de la commande .po
Si le décalage de page, c'est-à-dire l'espace entre le bord gauche du papier du document et la marge gauche du document, doit être défini, la commande .po peut être utilisée.
$ groff > grof_output_9 .po 10 Hi, .br Welcome to TGS!
10. Définissez la taille de la police à l'aide de la commande .ps
Si le texte doit être agrandi ou réduit, la commande .ps peut être utilisée. Veuillez noter que vous pouvez faire précéder l'argument de .ps avec - pour diminuer la taille de la police
$ groff > grof_output_10 Hi, .ps 20 Welcome to TGS!
Ce document ressemblera à ce qui suit lorsqu'il sera affiché dans une visionneuse de documents :
