aplat

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

commit 44f00559286d7cb6e00f37a515b1e33f224b5fb1
parent d676e7f35394771259e6d6e2fc80ae31348188bf
Auteur: Selve <selve@asteride.xyz>
Date:   Sun, 21 Jan 2024 15:05:30 -0500

modification d'aplat(5)

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