capsite

Ressources et outils pour la génération de ma capsule et de mon site
git clone git://git.asteride.xyz/~ldp/capsite.git
Journaux | Fichiers | Références

plat.5.txt.cp (3106B)


      1 PLAT(5)                  Manuel des formats de fichier                PLAT(5)
      2 
      3 NOM
      4      plat – Format de document structuré hiérarchiquement pour Unix
      5 
      6 DESCRIPTION
      7      plat est un format de document organisé en lignes et en champs qui permet
      8      la représentation de structures hiérarchiques.  Les utilitaires de
      9      traitement de texte conçus pour bien fonctionner dans un environnement
     10      Unix sont donc tout à fait capables de le manipuler.
     11 
     12      Le format se présente comme une suite de lignes, chacune séparée en trois
     13      champs : celui des étiquettes, celui des drapeaux et celui du contenu.
     14      Les champs sont séparés par des caractères de tabulation (‘\t’).
     15 
     16      Un domaine sectionne un document plat.  Les limites de tout domaine sont
     17      contenues à l’intérieur du domaine parent immédiat.  Le domaine racine,
     18      domaine absolument supérieur en ce qu’il n’a pas de parent et qu’il
     19      contient tous les autres domaines, fait exception à la règle.  Le domaine
     20      cadet est le domaine le plus imbriqué à un endroit donné du document.
     21      Tout domaine apparaît au moins une fois en position de domaine cadet, et
     22      ce même s’il est vide.
     23 
     24      Une étiquette nomme un domaine.  Le champ des étiquettes contient
     25      l’étiquette du domaine cadet courant de même que, le cas échéant, les
     26      étiquettes de tous ses domaines parents.  Ce champ a la forme d’une liste
     27      d’étiquettes ordonnée de telle sorte qu’un parent se trouve toujours à la
     28      gauche de son enfant.  Chaque étiquette de cette liste est précédée d’un
     29      deux-points (‘:’).  La dernière étiquette est aussi suivie d’un deux-
     30      points.  Il est impossible d’échapper les deux-points dans ce champ.
     31 
     32      Un drapeau permet d’identifier les limites d’un domaine.  La parenthèse
     33      ouvrante (‘(’) indique que la ligne est la première à être incluse dans
     34      un domaine donné; la parenthèse fermante (‘)’) indique que la ligne est
     35      la dernière à être incluse dans un domaine donné.
     36 
     37      Les champs contenu qui se suivent et qui appartiennent à un même domaine
     38      cadet sont concatenés.
     39 
     40      Les lignes étant séparées par des nouvelles lignes (‘\n’) et les champs
     41      par des caractères de tabulation (‘\t’), ces caractères sont échappés par
     42      ‘\n’ et ‘\t’, respectivement.  Le caractère d’échappement lui-même peut
     43      être échappé par ‘\\’.
     44 
     45 EXEMPLES
     46      L’exemple suivant (où un signe de dollar a été ajouté pour marquer la fin
     47      de la ligne) :
     48 
     49            :doc:   (       $
     50            :doc:par:       (       Que veut $
     51            :doc:par:               dire $
     52            :doc:par:it:    ()      placoter$
     53            :doc:par:       )        ?$
     54            :doc:   )       $
     55 
     56      est tout à fait équivalent au document aplat(5) suivant :
     57 
     58            (doc
     59              (par "Que veut dire " (it "placoter") " ?"))
     60 
     61 VOIR AUSSI
     62      aplat(1), aplat(5)
     63 
     64 AUTEURS
     65      Selve <selve@asteride.xyz>
     66 
     67                                 25 janvier 2024