commit 25e3d7079d1b3c6c8dfe4459f7cd6599602b87d6
parent c13ee78704369a30f081d2774abbf917b2239389
Auteur: Selve <selve@asteride.xyz>
Date: Sun, 21 Jan 2024 18:50:12 -0500
ajout d'un exemple à plat(5)
D'autres modifications, plutôt mineures, ont aussi été faites.
Diffstat:
| M | man/fr/plat.5 | | | 76 | +++++++++++++++++++++++++++++++++++++++++++++++++++------------------------- |
1 file changed, 51 insertions(+), 25 deletions(-)
diff --git a/man/fr/plat.5 b/man/fr/plat.5
@@ -11,12 +11,12 @@ représentation de structures hiérarchiques.
Les utilitaires de traitement de texte conçus pour bien fonctionner dans un
environnement Unix sont donc tout à fait capables de le manipuler.
.Pp
-Le format se présente comme une suite de lignes, chacunes séparés en trois
-champs\|: le champs des
+Le format se présente comme une suite de lignes, chacune séparée en trois
+champs\|: celui des
.Em étiquettes ,
-des
+celui des
.Em drapeaux
-et du
+et celui du
.Em contenu .
Les champs sont séparés par des caractères de tabulation
.Pq Sq \et .
@@ -25,46 +25,50 @@ Un
.Em domaine
sectionne un document
.Nm .
-Les limites de tout domaine doivent être
-contenues à l'intérieur du domaine parent immédiat.
-Le domaine
-.Em racine ,
-domaine absolument supérieur en ce qu'il n'a pas de parent
-et qu'il contient tous les autres domaines,
+Les limites de tout domaine sont
+contenues à l’intérieur du
+.Em "domaine parent"
+immédiat.
+Le
+.Em "domaine racine" ,
+domaine absolument supérieur en ce qu’il n’a pas de parent
+et qu’il contient tous les autres domaines,
fait exception à la règle.
-Le domaine
-.Em cadet
+Le
+.Em "domaine cadet"
est le domaine le plus imbriqué à un endroit donné du document.
.Pp
Une
.Em étiquette
nomme un domaine.
-Le champ des
-.Em étiquettes
-contient l'étiquette du domaine cadet courant
+Le champ des étiquettes
+contient l’étiquette du domaine cadet courant
de même que,
le cas échéant,
les étiquettes de tous ses domaines parents.
-Ce champ se présente sous la forme d'une liste d'étiquettes
-ordonnée de telle sorte que
-le parent se trouve se trouve toujours à la gauche de son enfant.
-Chaque étiquette de cette liste est précédée d'un deux-points
+Ce champ se présente sous la forme d’une liste d’étiquettes
+ordonnée de telle sorte qu’un
+parent se trouve se trouve toujours à la gauche de son enfant.
+Chaque étiquette de cette liste est précédée d’un deux-points
.Pq Sq :\& .
-Il est impossible d'échapper les deux-points dans ce champ.
+Il est impossible d’échapper les deux-points dans ce champ.
.Pp
Un
.Em drapeau
-permet d'identifier les limites d'un domaine.
-La paranthèse ouvrante
+permet d’identifier les limites d’un domaine.
+La parenthèse ouvrante
.Pq Sq \(
indique que la ligne est la première à être incluse dans un domaine donné\|;
la parenthèse fermante
.Pq Sq )\&
-indique la ligne est la dernière à être incluse dans un domaine donné.
+indique que la ligne est la dernière à être incluse dans un domaine donné.
.Pp
-Le champ
+Les champs
.Em contenu
-se passe d'explications.
+qui se suivent
+et qui appartiennent à un même
+.Em "domaine cadet"
+sont concatenés.
.Pp
Les lignes étant séparées par des nouvelles lignes
.Pq Sq \en
@@ -75,6 +79,28 @@ ces caractères sont échappés par
et
.Sq \et ,
respectivement.
+.Sh EXEMPLES
+L'exemple suivant
+(où un signe de dollar a été ajouté
+pour marquer la fin de la ligne)\|:
+.Bd -literal -offset indent
+:par ( Que $
+:par veut $
+:par dire $
+:par:it () placoter$
+:par ) ?$
+.Ed
+.Pp
+peut équivaloir
+au fragment de document html suivant
+(tout dépendant de l'interprétation qu'on assigne à
+.Em par
+et à
+.Em it )\c
+\|:
+.Bd -literal -offset indent
+<p>Que veut dire <i>placoter</i> ?</p>
+.Ed
.Sh VOIR AUSSI
.Xr aplat 1 ,
.Xr aplat 5
