commit 44f00559286d7cb6e00f37a515b1e33f224b5fb1
parent d676e7f35394771259e6d6e2fc80ae31348188bf
Auteur: Selve <selve@asteride.xyz>
Date: Sun, 21 Jan 2024 15:05:30 -0500
modification d'aplat(5)
Diffstat:
| M | man/fr/aplat.5 | | | 112 | ++++++++++++++++++++++++++++++++++++++++++++++--------------------------------- |
1 file changed, 66 insertions(+), 46 deletions(-)
diff --git a/man/fr/aplat.5 b/man/fr/aplat.5
@@ -1,4 +1,4 @@
-.Dd 2023-11-23
+.Dd 21 janvier 2024
.Dt APLAT 5
.Os
.Sh NOM
@@ -7,9 +7,9 @@
.Sh DESCRIPTION
.Nm aplat
est un format de document structuré hiérarchiquement conçu pour être facile à
-utiliser, aussi bien par un humain que par une machine.
+manipuler, aussi bien par un humain que par une machine.
.Pp
-C'est le format que
+C’est le format qu’\c
.Xr aplat 1
prend en entrée.
.Pp
@@ -26,24 +26,28 @@ et le
.Pp
Un
.Em domaine
-sectionne un document. Ses limites sont représentées par des parenthèses.
+sectionne un document.
+Ses limites sont notées par des parenthèses\ :
Les parenthèses ouvrante
.Pq Sq \(
et fermante
.Pq Sq )\&
-en marque le début et la fin, respectivement.
-Les limites de tout domaine (et plus généralement, de tout object) doivent être
-contenues à l'intérieur du domaine parent immédiat.
-Le 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.
+en marquent le début et la fin, respectivement.
+Les limites de tout domaine
+(et plus généralement, de tout object)
+doivent être contenues à l’intérieur du domaine parent immédiat.
+Le 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.
.Pp
-Lorsque l'étendue d'un domaine est la même que celle de son parent immédiat, il
-est possible d'utiliser le raccourcis syntaxique noté par le deux-points
+Lorsque l’étendue d’un domaine est la même que celle de son parent immédiat,
+il est possible d’utiliser le raccourcis syntaxique noté par un deux-points
.Pq Sq :\& .
-Dans cette notation, à gauche du deux-points se trouve le domaine parent et à
-droite, le domaine enfant.
-Il est possible d'ajouter de la sorte autant que domaines coextensifs à leur
-parent que le permet la mémoire disponible.
+Dans cette notation,
+à gauche du deux-points se trouve le domaine parent
+et à droite,
+le domaine enfant.
+Il est possible d’ajouter de la sorte autant que domaines qu'on le souhaite,
+et que le permet la mémoire disponible.
.Pp
Ces deux constructions sont donc équivalentes\|:
.Bd -literal -offset indent
@@ -57,10 +61,19 @@ Ces deux constructions sont donc équivalentes\|:
.Pp
Une
.Em étiquette
-nomme un domaine. Ce nom correspond au premier
+nomme un domaine.
+Ce nom correspond au premier
.Em atome
-du domaine.
-Ainsi, dans l'exemple ci-dessus,
+du domaine,
+à moins que le raccourcit syntaxique des deux-points ne soit utilisé.
+Comme règle générale,
+on peut dire que le premier
+.Em atome
+contient une
+.Em étiquette
+de plus
+que de deux-points.
+Ainsi, dans l’exemple ci-dessus,
.Em parent ,
.Em intermédiaire
et
@@ -69,48 +82,54 @@ sont des étiquettes.
.Pp
Le
.Em contenu
-d'un domaine correspond la concaténation de tous les atomes qu'il contient,
-excepté le premier, qui est l'\c
+d’un domaine correspond la concaténation de tous les atomes qu’il contient,
+excepté le premier, qui est l’\c
.Em étiquette .
.Pp
Finalement, un
.Em atome
est une suite de caractères séparés par des parenthèses ou par des espaces.
Sont traités comme des espaces les caractères suivants\|:
-l'espace normal
+l’espace normal
.Pq Sq \ ,
le saut de ligne
.Pq Sq \en
et le caractère de tabulation
.Pq Sq \et .
.Pp
-Il existe trois moyens d'échapper ces caractères\|: l'utilisation de la barre
+Il existe trois moyens d’échapper ces caractères\|: l’utilisation de la barre
oblique inversée
.Pq Sq \e\e ,
-l'encadrement avec des guillemets droits doubles
+l’encadrement avec des guillemets droits doubles
.Pq Sq \(dq
-et l'encadrement avec une suite de trois de ces guillemets
+et l’encadrement avec une suite de trois de ces guillemets
.Pq Sq \(dq\(dq\(dq .
.Pp
-Le caractère d'échappement
+Le caractère d’échappement
.Pq Sq \e
-change l'interprétation des caractères spéciaux. Son effet varie selon le
-caractère.
-Les parenthèses, les espaces normaux, les guillemets et les caractères
-d'échappement eux-mêmes sont interprétés dans leur sens littéral lorsque ce
+change l’interprétation des caractères spéciaux.
+Son effet varie selon le caractère échappé.
+Les parenthèses,
+les espaces normaux,
+les caractères de tabulation,
+les guillemets
+et les caractères
+d’échappement eux-mêmes sont interprétés dans leur sens littéral lorsque ce
caractère les précède.
-Cependant, une nouvelle ligne échappée est ignorée,
-et l'échappement de tout autre caractère est équivalent à ce même caractère sans
-échappement.
+Cependant,
+une nouvelle ligne échappée est ignorée,
+et l’échappement de tout autre caractère est équivalent
+à ce même caractère sans échappement.
.Pp
-Lorsqu'une chaîne de caractères est placée entre guillemets droits doubles
+Lorsqu’une chaîne de caractères est placée entre guillemets droits doubles
.Pq Sq \(dq ,
-les espaces recoivent leur interprétation littérale.
-C'est le seul apport de ces guillemets.
-Le comportement du caractère d'échappement est le même à l'intérieur de
-guillemets qu'à l'extérieur.
+les espaces
+et les parenthèses
+recoivent leur interprétation littérale.
+Le comportement du caractère d’échappement est le même à l’intérieur de
+guillemets qu’à l’extérieur.
.Pp
-La dernière stratégie d'échappement a recourt à un
+La dernière stratégie d’échappement a recourt à un
.Em bloc .
Un bloc est délimité par une paire de triples guillemets droits doubles
.Pq Sq \(dq\(dq\(dq .
@@ -120,26 +139,27 @@ ligne
inclusivement, et ceux qui se trouvent de la dernière nouvelle ligne et le
triplet fermant, inclusivement, sont ignorés.
Ces caractères ignorés peuvent servir à donner certaines informations à
-d'éventuels préprocesseurs.
-Le texte qui se trouve à l'intérieur d'un bloc est interprété
+d’éventuels préprocesseurs.
+Le texte qui se trouve à l’intérieur d’un bloc est interprété
.Em verbatim .
-Une construction spéciale permet d'y inclure une suite de trois guillemets.
-Il suffit de les faire suivre d'un point d'exclamation
+Une construction spéciale permet d’y inclure une suite de trois guillemets.
+Il suffit de les faire suivre d’un point d’exclamation
.Pq Sq !\&
.Pp
Ainsi, les trois constructions suivantes sont équivalentes\|:
.Bd -literal -offset indent
(doc
- (par La\e suite\e \e"\e"\e"\e marque\e les\e limites\e d'un\e bloc.))
+ (par La\e suite\e \e"\e"\e"\e marque\e les\e limites\e d’un\e bloc.))
.Ed
.Bd -literal -offset indent
(doc
- (par "La suite \e"\e"\e" marque les limites d'un bloc."))
+ (par "La suite \e"\e"\e" marque les limites d’un bloc."))
.Ed
.Bd -literal -offset indent
(doc
- (par """ type=texte
-La suite """! marque les limites d'un bloc.
+ (par
+""" type=texte
+La suite """! marque les limites d’un bloc.
"""))
.Ed
.Sh VOIR AUSSI
