aplat

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

commit d9f852af01cd6f1a41ba481222e7160b9cc59723
parent 54ff2439e82d9e13791a806d3541018480a60b18
Auteur: Loïc Daignault-Pichette <loic@asteride.xyz>
Date:   Sat,  8 Jun 2024 16:30:03 -0400

mise à jour des traductions en catalan

Diffstat:
Mman/ca/aplat.1 | 18+++++++++++-------
Mman/ca/aplat.5 | 137++++++++++++++++++++++++++++++++-----------------------------------------------
Mman/ca/plat.5 | 49+++++++++++++++++++++++++------------------------
Mman/fr/aplat.1 | 2+-
Mman/fr/aplat.5 | 13++++++-------
Mman/fr/plat.5 | 7+------
6 files changed, 100 insertions(+), 126 deletions(-)

diff --git a/man/ca/aplat.1 b/man/ca/aplat.1 @@ -1,16 +1,16 @@ -.Dd 4 d’abril de 2024 +.Dd 8 de juny de 2024 .Dt APLAT 1 .Os .Sh NOM .Nm aplat -.Nd Converteix el format aplat al format plat +.Nd Converteix el format aplat(5) al format plat(5) .Sh SINOPSI .Nm aplat <\c -.Ar fitxer +.Ar fichier .br .Nm aplat -.Fl V +.Fl V | h .Sh DESCRIPCIÓ La utilitat .Nm aplat @@ -25,6 +25,9 @@ Quan és executat amb l’opció .Fl V , la versió del programari és enviada a la sortida estàndard. +Amb l’opció +.Fl h , +apareix el seu sinopsi. .Sh EXEMPLES Si el fitxer .Pa exemple.aplat @@ -56,12 +59,13 @@ surt amb 0 si tot ha anat bé i amb >0 si un error ha ocurregut. .Xr aplat 5 , .Xr plat 5 .Sh AUTORS -.An Selve <selve@asteride.xyz> +.An Loïc Daignault-Pichette <loic@asteride.xyz> .Sh TRADUCCIÓ Aquesta pàgina del manual va ser traduïda +per primera vegada de la seva versió original en francès per -.An Selve <selve@asteride.xyz> +.An Loïc Daignault-Pichette <loic@asteride.xyz> al mes d’abril de 2024 -i està actualitzada amb la versió 2.0 de la utilitat. +i està actualitzada amb la versió 2.0-ε/1 de la utilitat. diff --git a/man/ca/aplat.5 b/man/ca/aplat.5 @@ -1,4 +1,4 @@ -.Dd 4 d’abril de 2024 +.Dd 8 de juny de 2024 .Dt APLAT 5 .Os .Sh NOM @@ -7,14 +7,16 @@ .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. +fàcil d’escriure i de manipular pels humans. +És equivalent al format +.Xr plat 5 . .Pp -És el format de l’entrada d’\c +És el format de l’entrada de la utilitat .Xr aplat 1 . .Pp El format .Nm aplat -es compon de quatre tipus d’objectes\~: +es compon de quatre tipus d’objecte\~: .Em domini , .Em àtom , .Em etiqueta @@ -39,62 +41,28 @@ 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 +Cada parèntesi obert ha de tenir un parèntesi tancat corresponent. .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. +del domini. +La seva llargària +no pot superar +els 128 octets. .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 . +que conté l’\c +.Em etiqueta . .Pp En fi, un -.Em àtom , +.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 @@ -109,30 +77,30 @@ 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 . +i l’emmarcació entre +signes d’igualtat +col·locats a l’inici d’una línia +.Pq Sq \en= . .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, +Una línia nova escapada és ignorada. +Els altres caràcters escapats, +incloent-hi +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. +et els mateixos caràcters d’escapament, +reben una interpretació literal. .Pp -Quan una cadena de caràcter és emmarcada entre cometes rectes dobles +Quan una cadena de caràcters és emmarcada entre cometes rectes dobles .Pq Sq \(dq , els blancs i els parèntesis -reben les seves interpretaciós literals. +reben les seves interpretacions literals. El comportament del caràcter d’escapament és el mateix a dins i a fora de les cometes. @@ -145,51 +113,58 @@ 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, +Un bloc és delimitat +per un parell de signes d’igualtat +col·locats a l’inici d’una línia. +.Pq Sq \en= . +Els caràcters que es troben +en les mateixes línies +que aquests signes d’igualtat són ignorats. -Aquests caràcters ignorats poden servir per +Així, +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. +Els separators de blocs +sempre són interpretats com a tals, +i els mecanismes d’escapament normals +no tenen cap efecte sobre ells. +Una construcció especial permet incloure-hi +signes d’igualtat +a l’inici d’una línia. Només cal afegir-hi un signe d’exclamació .Pq Sq !\& +Un bloc pot ser encastat +entre un parell de cometes. .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 +Així doncs, les dues construccions següents són equivalents: .Bd -literal -offset indent (doc - (par "Un bloc és delimitat pel seguit \e"\e"\e".")) + (par "La línia següent comença per un signe d’igualtat\~: +=!")) .Ed .Bd -literal -offset indent (doc (par -""" type=text -Un bloc és delimitat pel seguit """!. -""")) += tipus:text +La línia següent comença per un signe d’igualtat\~: +=! += +)) .Ed .Sh VEGEU TAMBÉ .Xr aplat 1 , .Xr plat 5 .Sh AUTORS -.An Selve <selve@asteride.xyz> +.An Loïc Daignault-Pichette <loic@asteride.xyz> .Sh TRADUCCIÓ Aquesta pàgina del manual va ser traduïda +per primera vegada de la seva versió original en francès per -.An Selve <selve@asteride.xyz> +.An Loïc Daignault-Pichette <loic@asteride.xyz> al mes d’abril de 2024 -i està actualitzada amb la versió 2.0 de la utilitat. +i està actualitzada amb la versió 2.0-ε/1 de la utilitat. diff --git a/man/ca/plat.5 b/man/ca/plat.5 @@ -1,4 +1,4 @@ -.Dd 5 d'abril de 2024 +.Dd 5 d’abril de 2024 .Dt PLAT 5 .Os .Sh NOM @@ -13,15 +13,15 @@ concebudes per funcionar bé dins un environment Unix són, doncs, -amb una mica d'ajuda, +amb una mica d’ajuda, perfectament capaces de manipular-lo. .Pp El format es presenta com un seguit de línies, cadascuna separada en tres camps: el de les .Em banderes , -el de les -.Em etiquetes +el de l’\c +.Em etiqueta i el del .Em contigut . Els camps són separats per caràcters de tabulació @@ -48,24 +48,19 @@ i això encara que sigui buit. .Pp Una .Em bandera -permet identificar els límits d'un domini. +permet identificar els límits d’un domini. El parèntesi obert .Pq Sq \( -indica que la línia és la primera d'un domini donat; +indica que la línia és la primera d’un domini donat; el parèntesi tancat .Pq Sq )\& -indica que la línia és l'última d'un domini donat. +indica que la línia és l’última d’un domini donat. .Pp Una .Em etiqueta anomena un domini. -L'etiqueta de cada domini es mostra una sola vegada, +L’etiqueta de cada domini es mostra una sola vegada, al principi del domini corresponent. -En altres paraules, -si el camp de l'etiqueta no és buit, -el camp de les banderes contindrà almenys -.Sq \( , -i viceversa. .Pp Els camps .Em contingut @@ -83,13 +78,18 @@ aquests caràcters han de ser escapats amb i .Sq \et , respectivament. -El mateix caràcters d'escapament ha de ser escapat amb -.Sq \e\e . +El dos punts +i el el mateix caràcter d’escapament +han de ser escapat amb +.Sq \ed +i +.Sq\ee , +respectivament. No és possible escapar els altres caràcters. .Sh EXEMPLES -L'exemple següent -(en el qual un símbol de dòlar ha estat afegit -per significar la fi d'una línia): +L’exemple següent +(en el qual uns símbols de dòlar han estat afegits +per significar la fi d’una línia): .Bd -literal -offset indent ( doc $ ( par Què vol $ @@ -115,17 +115,18 @@ El format .Nm va canviar amb la versió 2.0 de la utilitat .Xr aplat 1 . -Abans d'aquesta publicació, -el camp de les banderes seguia el de les etiquetes, +Abans d’aquesta publicació, +el camp de les banderes seguia el de l’etiqueta, i aquest últim contenia tota la jeràrquia de les etiquetes, del domini arrel al domini buderol. .Sh AUTORS -.An Selve <selve@asteride.xyz> +.An Loïc Daignault-Pichette <loic@asteride.xyz> .Sh TRADUCCIÓ Aquesta pàgina del manuel va ser traduïda +per primera vegada 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. +.An Loïc Daignault-Pichette <loic@asteride.xyz> +al mes d’abril de 2024 +i està actualitzada amb la versió 2.0-ε/1 de la utilitat. diff --git a/man/fr/aplat.1 b/man/fr/aplat.1 @@ -24,7 +24,7 @@ Lorsque est exécuté avec l’option .Fl V , la version du programme est affichée en sortie standard. -Avec l'option +Avec l’option .Fl h , son synopsis est affiché. .Sh EXEMPLES diff --git a/man/fr/aplat.5 b/man/fr/aplat.5 @@ -93,8 +93,7 @@ les espaces normales, 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. +reçoivent une interprétation littérale. .Pp Lorsqu’une chaîne de caractères est placée entre guillemets droits doubles .Pq Sq \(dq , @@ -115,19 +114,19 @@ Un bloc est délimité par une paire de signes d’égalité placés en début de ligne .Pq Sq \en= . Les caractères qui se trouvent -sur la même ligne que ces signes d’égalité +sur les mêmes lignes que ces signes d’égalité sont ignorés. Ils peuvent ainsi servir à donner certaines informations à d’éventuels préprocesseurs. Le texte qui se trouve à l’intérieur d’un bloc est interprété .Em verbatim . Les séparateurs de blocs sont interprétés comme tels -en tout temps -et les mécanismes d'échappement normaux -n'ont aucun effet sur lui. +en tout temps, +et les mécanismes d’échappement normaux +n’ont aucun effet sur lui. Une construction spéciale permet d’échapper -les singes d’égalité +des signes d’égalité en début de ligne. Il suffit de les faire suivre d’un point d’exclamation diff --git a/man/fr/plat.5 b/man/fr/plat.5 @@ -59,11 +59,6 @@ Une nomme un domaine. L’étiquette de chaque domaine n’est affichée qu’une seule fois, à l’ouverture du domaine. -Autrement dit, -si le champ de l’étiquette n’est pas vide, -celui des drapeaux contient au moins -.Sq \( , -et vice-versa. .Pp Les champs .Em contenu @@ -91,7 +86,7 @@ respectivement. Il est interdit d’échapper tout autre caractère. .Sh EXEMPLES L’exemple suivant -(où des signes de dollar a été ajouté +(où des signes de dollar ont été ajoutés pour marquer la fin de la ligne)\~: .Bd -literal -offset indent ( doc $