Comment utiliser Troff pour formater des documents PDF sous Linux
Troff est un traitement de texte de document simple mais puissant pour les systèmes Linux. Il vous permet de créer facilement des documents prêts à imprimer en compilant des fichiers source à partir de la ligne de commande. contrairement à Latex Troff est incroyablement léger et est préinstallé sur la plupart des systèmes Linux. Ce tutoriel vous montre comment utiliser Troff pour formater des documents PDF dans Ubuntu.
Qu'est-ce que Troff et pourquoi l'utilisez-vous ?
au sens le plus élémentaire, Troff Il s'agit d'un programme de traitement de texte qui convertit des scripts qui ressemblent à du code en documents imprimables. Contrairement aux traitements de texte, Troff ne s'appuie pas sur le modèle "WYSIWYG". Au lieu de cela, il vous oblige à utiliser certains types de code pour gérer votre formatage.
La simplicité est l'un des plus grands avantages de ce style. L'installation de base de Troff contiendra tout ce dont vous avez besoin pour créer un document. De plus, son absence d'interface utilisateur graphique signifie que vous pouvez créer un document même via SSH.
Conseil : Apprenez à transférer Applications GUI sur SSH Sous Linux.
Installation de Troff
Troff est souvent fourni par défaut dans la plupart des distributions Linux. Vous pouvez vérifier si vous l'avez dans votre système en exécutant son indicateur -h. Cela affichera une courte liste de toutes les balises acceptées par l'installation de Troff.
troff -h
Il y a des cas où les distributions ne compilent pas Troff par défaut. Dans ce cas, vous pouvez l'installer en recherchant le package "groff".
Il s'agit d'une réimplémentation des programmes Troff et Nroff par le projet GNU, qui inclut un certain nombre de nouvelles fonctionnalités modernes.
Vous pouvez installer groff dans Ubuntu avec la commande suivante :
sudo apt installer groff
Créer le premier document Troff
Semblable au code source, chaque document Troff est un fichier texte contenant des instructions sur la façon de créer un document. Cela inclut la largeur et la marge de la page ainsi que l'espacement des caractères et des pages.
Ce niveau de contrôle vous permet de manipuler le programme pour créer tout type de document. Pour simplifier, les développeurs de Troff ont créé des "macros" qui condensent ces commandes dans une syntaxe plus simple.
L'une des macros les plus courantes que vous utiliserez dans Troff est Milliseconds. Un document de style essai sera créé. Vous pouvez créer un document ms avec la commande touch :
touchez mon-premier-document.ms
Étant donné que tous les documents Troff sont du texte, vous pouvez ouvrir le document avec un éditeur de texte. Dans mon cas, j'utilise vim. Alternativement, vous pouvez utiliser n'importe lequel de ces éditeurs de texte pour Linux.
vim mon-premier-document.ms
Comprendre le format Troff
Tous les documents de Troff suivent une structure similaire. Chaque commande de formatage que vous effectuez doit figurer sur une ligne distincte dans le contenu qu'elle tente de formater. En tant que tel, un document Troff typique ressemblerait à ceci :
.COMMAND1 Il s'agit d'un élément de contenu dans un document Troff. .COMMAND2 Il s'agit d'un élément de contenu différent dans un document Troff.
Deux des commandes les plus élémentaires que vous utiliserez en quelques millisecondes sont TL et .PP. Le premier convertit votre texte en titre et le centre dans votre document, tandis que le second formate votre texte pour suivre un style de paragraphe.
Par exemple, l'extrait de code suivant utilise à la fois les commandes TL et .PP :
.TL Mon premier document Troff .PP C'est le contenu que je veux voir comme un paragraphe dans mon document final. Ce n'est pas un contenu très long mais c'est mon premier document Troff et c'est quelque chose dont je suis fier. Il contient environ trois phrases et doit envelopper correctement le document.
À partir de là, créez votre document en transmettant votre fichier au logiciel de Troff.
groff -ms -Tpdf ./mon-premier-document.ms > sortie.pdf
Conseil : Si vous préférez quelque chose de plus simple, découvrez comment Écrire au format MLA dans Google Docs.
Créer du texte en gras, en italique et souligné
Tout comme un traitement de texte ordinaire, la plupart des macros Troff fournissent un certain nombre de commandes de style pour la personnalisation du document. Pour ms, ce sont .B et . Moi et. UL et .BX.
- La commande B met le texte en gras.
- La commande .I met le texte en italique.
- UL et. BX sont deux commandes qui dessinent respectivement un soulignement et un cadre autour du texte.
Semblable aux commandes ci-dessus, l'utilisation de ces commandes dans votre document nécessite que chaque style soit séparé sur sa propre ligne :
.TL Mon premier document Troff .PP C'est le contenu .B .R que je veux voir comme un paragraphe dans mon document final. [...]
Dans cet exemple, j'ai créé une nouvelle ligne avant un mot "contenu" Et j'ai ajouté la commande .B pour la changer en gras, puis j'ai créé une nouvelle ligne et ajouté la commande .R. Cela permet à Troff de revenir à sa technique précédente.
Il est important de noter que vous devez toujours ajouter la commande .R lors du changement de style. Par exemple, l'extrait de code suivant ne terminera pas la commande .I car Troff n'a pas vu le fichier .R après :
.TL Mon premier document Troff .PP C'est pour moi que je veux ressembler à un paragraphe dans mon document final. [...]
Créer de nouvelles sections de documents
Semblable à LaTeX, Troff prend également en charge la détection et la hiérarchie des partitions, vous n'avez donc pas besoin de commander et de faire correspondre le niveau de chaque en-tête lors de l'édition.
Pour créer une nouvelle section dans votre document, utilisez la commande .NH suivie du nom de votre en-tête.
.TL Mon premier document Troff .NH Mon premier titre .PP C'est le contenu que je veux voir comme un paragraphe dans mon document final.
Par défaut, chaque en-tête Troff contient une valeur de niveau qui détermine la façon dont le programme est construit et son contenu affiché dans le document final. Sachant que vous pouvez modifier cette valeur pour ajuster le niveau de cap.
Par exemple, ce qui suit crée une adresse de niveau 2 juste en dessous de l'adresse parent :
.TL Mon premier document Troff .NH Mon premier titre .NH 2 Mon premier sous-titre .PP C'est le contenu que je veux voir comme un paragraphe dans mon document final.
Outre les en-têtes numérotés réguliers, Troff peut également créer des en-têtes vides qui suivront toujours la hiérarchie au niveau du document.
Pour cela, remplacez .NH par la commande SH :
.TL Mon premier document Troff .SH Mon premier titre .SH 2 Mon premier sous-titre .PP C'est le contenu que je veux voir comme un paragraphe dans mon document final.
Conseil: découvrez comment Modifier les marges dans Google Docs.
Créer des listes dans Troff
La simplicité de Troff vous permet également de transformer son comportement en tout ce que vous désirez. Par exemple, les listes ne sont pas fournies par défaut sur les macros Troff ou ms. Malgré cela, vous pouvez toujours créer une liste en combinant quelques commandes ms.
Chaque liste dans Troff est composée de trois parties : retrait, puce et contenu. Pour créer un retrait, utilisez les commandes .rs et .rs. CONCERNANT. Cela indentera le niveau d'indentation actuel de tout texte qu'il contient de quatre espaces.
.RS C'est mon premier article. .CONCERNANT
Ensuite, créez la puce de votre élément de menu avec le .IP. Il s'agit d'une commande Retrait de paragraphe qui fixe la marge gauche du texte à une largeur spécifique.
La commande IP vous permet également de définir une puce personnalisée et l'espace entre celle-ci et votre texte. Dans ce cas, je définirais ma puce sur "[1]" et lui donnerais quatre espaces.
.RS .IP [1] 4 Ceci est mon premier article. .CONCERNANT
Maintenant, copiez et collez votre commande IP pour créer des éléments de menu supplémentaires.
.RS .IP [1] 4 Ceci est mon premier article. .IP [2] 4 Ceci est mon deuxième article. .IP [3] 4 Ceci est mon troisième article. .CONCERNANT
Enfin, automatisez ce processus en créant une macro personnalisée. Par exemple, l'extrait de code suivant associe ma commande IP à QW.
.de QW .IP [-] 4 .. .RS .QW Ceci est mon premier article. .QW C'est mon deuxième article. .QW C'est mon troisième article. .CONCERNANT
Créer des tables avec des préprocesseurs dans Troff
L'une des choses étranges à propos de Troff est que la plupart de ses fonctionnalités sont là en tant que "Traitements primaires". Pour la plupart, ce sont des binaires hors programme qui fonctionnent en créant "Scripts de conteneur de préprocesseur" et convertissez-le en code Troff de bas niveau.
Tbl est un excellent exemple de préprocesseur Troff. C'est un programme qui gère les tableaux d'un document. Le conteneur Tbl de base ressemble à ceci :
.TS allbox ; cc c. objet 1 article2 article3 article4 article5 article6.TE
- Les commandes .TS et .TE indiquent à Tbl qu'il s'agit d'un environnement qu'il peut lire.
- La deuxième ligne indique au programme comment formater cette table.
- La troisième ligne est un champ séparé par des espaces qui définit le nombre de colonnes et l'alignement de votre tableau.
- Les quatrième et cinquième lignes sont des champs séparés par des tabulations qui contiennent le contenu de votre table.
Compiler un document à l'aide de Tbl est un peu différent d'un fichier Troff normal. Tout d'abord, téléchargez votre fichier :
tbl mon-premier-document.ms > prétraité.ms
Ensuite, envoyez la sortie du programme à Troff :
groff -ms -Tpdf ./preprocessed.ms > sortie.pdf
Enfin, automatisez ce processus à l'aide de canaux UNIX :
tbl mon-premier-document.ms | groff -ms -Tpdf > sortie.pdf
Questions fréquemment posées:
Q1 : Est-il possible d'utiliser Troff sous Windows ?
réponse. Par défaut, Troff et Groff ne sont pas officiellement portés sur Windows. Malgré cela, vous pouvez toujours utiliser Groff avec d'autres outils GNU en Installer le sous-système Windows pour Linux.
Q2 : Troff dispose-t-il d'une fonctionnalité de suivi de la bibliographie ?
réponse. Oui. Referral est un préprocesseur simple qui utilise un fichier de bibliographie externe pour suivre automatiquement les références dans un document Troff. Vous pouvez en savoir plus sur son fonctionnement en visitant sa page de manuel en exécutant l'homme de référence.
Q3 : Comment puis-je corriger l'erreur "DESC manquant" lors de la compilation de Troff ?
réponse. Ce problème est probablement dû à une dépendance manquante dans votre système ou à un fichier de version incompatible. Pour résoudre ce problème, installez le package groff approprié à partir du référentiel de votre distribution.