commit e81e34c35fde22a0a8c861c2e000c0e51658afba parent 7326bea9defa034bab9957fee7d8da0b95c46d3f Auteur: Selve <selve@asteride.xyz> Date: Sat, 6 Apr 2024 15:34:18 -0400 écriture de la page d'accumuler(1) Diffstat:
| A | man/fr/accumuler.1 | | | 97 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
1 file changed, 97 insertions(+), 0 deletions(-)
diff --git a/man/fr/accumuler.1 b/man/fr/accumuler.1 @@ -0,0 +1,97 @@ +.Dd 6 avril 2024 +.Dt ACCUMULER 1 +.Os +.Sh NOM +.Nm accumuler +.Nd Accumuler la hiérarchie des étiquettes +.Sh SYNOPSIS +.Nm +<\c +.Ar fichier +.Nm +.Fl V +.Sh DESCRIPTION +L’utilitaire +.Nm +lit en entrée standard et écrit en sortie standard. +Il a pour but de faciliter le travail +aux utilitaires de traitement de texte Unix. +Il modifie le champ des étiquettes +d’un document +au format +.Xr plat 5 +en y plaçant +toute la hiérarchie des étiquettes, +du +.Em "domaine racine" +au +.Em "domaine cadet" . +Des deux-points +.Pq Sq ":" +sont placés à gauche et à droite les étiquettes. +.Pp +Le document ainsi transformé +n’est plus un document +.Xr plat 5 +valide. +.Pp +Lorsque +.Nm +est exécuté avec l’option +.Fl V , +la version du programme est affichée en sortie standard. +.Sh EXEMPLES +En supposant que le fichier +.Pa livres.plat +a le contenu suivant\~: +.Bd -literal -offset indent +$ aplat <livres.plat +( doc +( @ +() titre Liste de livres +() date 2024-04-06 +) +( livre +( @ +() titre Candide ou l’optimisme +() auteur Voltaire +() date 1759 +) +) +) +.Ed +.Pp +La commande suivante affiche le texte suivant\~: +.Bd -literal -offset indent +$ accumuler <livres.plat +( :doc: +( :doc:@: +() :doc:@:titre: Liste de livres +() :doc:@:date: 2024-04-06 +) :doc:@: +( :doc:livre: +( :doc:livre:@: +() :doc:livre:@:titre: Candide ou l’optimisme +() :doc:livre:@:auteur: Voltaire +() :doc:livre:@:date: 1759 +) :doc:livre:@: +) :doc:livre: +) :doc: +.Ed +.Pp +Il est alors possible d’utiliser +.Xr grep 1 +pour extraire le titre des livres plutôt que le titre du document\~: +.Bd -literal -offset indent +$ acculumer <livres.plat | grep ':livre:@:titre: ' | cut -f3 +Candide ou l’optimisme +.Ed +.Sh ÉTATS DE SORTIE +L’utilitaire +.Nm +quitte avec 0 si tout s’est bien passé et avec >0 si une erreur est survenue. +.Sh VOIR AUSSI +.Xr aplat 1 +.Xr plat 5 +.Sh AUTEURS +.An Selve <selve@asteride.xyz>