aplat

Documents structurés pour Unix
git clone git://git.asteride.xyz/~ldp/aplat.git
Journaux | Fichiers | Références | LISEZ-MOI | LICENCE

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:
Mman/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