commit 790e7dad55ae2b57911cc4af9e6e97f798636e8a
parent 1f5f936a1c593be8b257136aa43bd3d8a3780c90
Auteur: Selve <selve@asteride.xyz>
Date: Fri, 5 Apr 2024 16:56:14 -0400
traduction de la page d'aplat(5) au catalan
L'originale en français, de même que la version catalane d'aplat(1) ont été
retouchées.
Diffstat:
4 files changed, 202 insertions(+), 7 deletions(-)
diff --git a/changements.txt b/changements.txt
@@ -15,7 +15,7 @@ Version 2.0 (???)
* accumuler(1): Ajout d'un programme qui, à la manière de la sortie de la
version 1.0 d'aplat(1), accumule dans le champ des étiquettes toutes les
étiquettes parentes d'un domaine.
-* traductions: catalan: aplat(1)
+* traductions: catalan: aplat(1), aplat(5)
Version 1.0 (2024/01/25)
-----------
diff --git a/man/ca/aplat.1 b/man/ca/aplat.1
@@ -59,9 +59,9 @@ surt amb 0 si tot ha anat bé i amb >0 si un error ha ocurregut.
.An Selve <selve@asteride.xyz>
.Sh TRADUCCIÓ
Aquesta pàgina del manual
-var ser traduïda
+va ser traduïda
de la seva versió original en francès
per
.An Selve <selve@asteride.xyz>
-al més d’abril de 2024
-i està actualitzat amb la versió 2.0 de la utilitat.
+al mes d’abril de 2024
+i està actualitzada amb la versió 2.0 de la utilitat.
diff --git a/man/ca/aplat.5 b/man/ca/aplat.5
@@ -0,0 +1,195 @@
+.Dd 4 d’abril de 2024
+.Dt APLAT 5
+.Os
+.Sh NOM
+.Nm aplat
+.Nd Format de document estructurat de manera jeràrquica.
+.Sh DESCRIPCIÓ
+.Nm aplat
+és un format de document estructurat de manera jeràquica concebut per ser
+fàcil d’escriure i de manipular, tant pels humans com per les màquines.
+.Pp
+És el format de l’entrada d’\c
+.Xr aplat 1 .
+.Pp
+El format
+.Nm aplat
+es compon de quatre tipus d’objectes\~:
+.Em domini ,
+.Em àtom ,
+.Em etiqueta
+i
+.Em contigut .
+.Pp
+Un
+.Em domini
+divideix un document.
+Els seus límits són notats per parèntesis\~:
+els parèntesis oberts
+.Pq Sq \(
+i tancats
+.Pq Sq )\&
+en marquen l’inici i el final, respectivament.
+Els límits d’un domini
+(o de manera més general, d’un objecte)
+han de trobar-se dins del
+.Em "domini pare"
+immediat.
+El
+.Em "domini arrel" ,
+domini asbolutament superior pel fet que no té pare
+i que conté tots els altres dominis, és una excepció de la regla.
+Evidentment, cada parèntesi obert ha de tenir un parèntesi tancat corresponent.
+.Pp
+Quan l’extensió d’un domini és el mateix que el del seu pare immediat,
+és possible fer servir la facilitat sintàctica notada per un dos punts
+.Pq Sq :\& .
+Amb aquesta notació,
+a l’esquerra del dos punts es troba el
+.Em "domini pare" ,
+i a la seva dreta,
+el
+.Em "domini fill" .
+D’aquesta manera,
+és possible afegir tants dominis coextensius com es vulgui,
+i com ho permeti la quantitat de memòria disponible en el sistema.
+.Pp
+Aquestes dues construccions són, doncs, equivalents\~:
+.Bd -literal -offset indent
+(pare
+ (intermediari
+ (fill "Contigut del domini")))
+.Ed
+.Bd -literal -offset indent
+(pare:intermediari:fill "Contingut del domini")
+.Ed
+.Pp
+Una
+.Em etiqueta
+anomena un domini.
+Aquest nom correspon al primer
+.Em àtom
+del domini,
+tret que la facilitat sintàctica del dos punts es faci servir.
+De fet,
+podem dir que el primer
+.Em àtom
+conté una
+.Em etiqueta
+més
+que de dos punts.
+En els dos exemples anteriors,
+.Em pare,
+.Em intermediari
+i
+.Em fill
+són etiquetes.
+.Pp
+El
+.Em contigut
+d’un domini correspon a la concatenació de tots els àtoms que conté,
+llevat del primer,
+que conté la o les
+.Em etiquetes .
+.Pp
+En fi,
+un
+.Em àtom ,
+és una cadena de caràcters separats per parèntesis o blancs.
+Són tractats com a blancs els caràcters següents\~:
+l’espai normal
+.Pq Sq \ ,
+la línia nova
+.Pq Sq \en
+i el caràcter de tabulació
+.Pq Sq \et .
+.Pp
+Existeixen tres maneres d’escapar caràcters\~:
+la utilització de la barra obliqua inversa
+.Pq Sq \e\e ,
+l’emmarcació entre cometes rectes dobles
+.Pq Sq \(dq
+i l’emmarcació entre un seguit de tres d’aquest tipus de cometes
+.Pq Sq \(dq\(dq\(dq .
+.Pp
+El caràcter d’escapament
+.Pq Sq \e
+canvia la interpretació dels caràcters especials.
+El seu efecte varia segons el caràcter escapat.
+Els parèntesis,
+els espais normals,
+els caràcters de tabulació,
+les cometes
+i el mateix caràcter d’escapament
+reben una interpretació literal
+quan aquest caràcter els precedeix.
+Tanmateix,
+una línia nova escapada és ignorada,
+i l’escapament d’un altre caràcter és equivalent
+a aquest mateix caràcter sense escapament.
+.Pp
+Quan una cadena de caràcter és emmarcada entre cometes rectes dobles
+.Pq Sq \(dq ,
+els blancs
+i els parèntesis
+reben les seves interpretaciós literals.
+El comportament del caràcter d’escapament
+és el mateix a dins i a fora
+de les cometes.
+Les cometes no han de trobar-se
+a les extremitats dels àtoms,
+sinò que funcionen més aviat com a commutadors
+que canvien el mode d’interpretació.
+En això,
+s’assemblen a les cometes dels intèrprets d’ordres de Unix.
+.Pp
+L’última estratègia d’escapament recorre a un
+.Em bloc .
+Un bloc és delimitat per un parell de triples cometes rectes dobles
+.Pq Sq \(dq\(dq\(dq .
+Els caràcters que es troben entre el triplet obert
+i la primera línia nova
+.Pq Sq \en ,
+inclusivament,
+i els que es troben entre l’última línia nova
+i el triplet tancat,
+inclusivament,
+són ignorats.
+Aquests caràcters ignorats poden servir per
+transmettre algunes informacions
+a uns preprocessors eventuals.
+El text que es troba dins d’un bloc és interpretat
+.Em verbatim .
+Una construcció especial permet incloure-hi un seguit de tres cometes.
+Només cal afegir-hi un signe d’exclamació
+.Pq Sq !\&
+.Pp
+Així doncs, les tres construccions següents són equivalents:
+.Bd -literal -offset indent
+(doc
+ (par Un\e bloc\e és\e delimitat\e pel\e seguit\e \e"\e"\e"\e.))
+.Ed
+.Bd -literal -offset indent
+(doc
+ (par "Un bloc és delimitat pel seguit \e"\e"\e"."))
+.Ed
+.Bd -literal -offset indent
+(doc
+ (par
+""" type=text
+Un bloc és delimitat pel seguit """!.
+"""))
+.Ed
+.Sh VEGEU TAMBÉ
+.Xr aplat 1 ,
+.Xr plat 5
+.Sh AUTORS
+.An Selve <selve@asteride.xyz>
+.Sh TRADUCCIÓ
+Aquesta pàgina del manual
+va ser traduïda
+de la seva versió original en francès
+per
+.An Selve <selve@asteride.xyz>
+al mes d’abril de 2024
+i està actualitzada amb la versió 2.0 de la utilitat.
diff --git a/man/fr/aplat.5 b/man/fr/aplat.5
@@ -1,4 +1,4 @@
-.Dd 25 janvier 2024
+.Dd 4 avril 2024
.Dt APLAT 5
.Os
.Sh NOM
@@ -43,7 +43,7 @@ et qu’il contient tous les autres domaines, fait exception à la règle.
Il va de soi que les parenthèses de tout domaine doivent être équilibrées.
.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 un deux-points
+il est possible d’utiliser le raccourci syntaxique noté par un deux-points
.Pq Sq :\& .
Dans cette notation,
à gauche du deux-points se trouve le
@@ -139,7 +139,7 @@ réglant le mode d’interprétation.
Ils ressemblent en cela
aux guillemets des interpréteurs de commandes Unix.
.Pp
-La dernière stratégie d’échappement a recourt à un
+La dernière stratégie d’échappement a recours à un
.Em bloc .
Un bloc est délimité par une paire de triples guillemets droits doubles
.Pq Sq \(dq\(dq\(dq .
