Didier : Page créée avec « '''YAML''', acronyme récursif de '''YAML Ain't Markup Language''', est un format de représentation de données par sérialisation Unicode. Il rep... »

2014-02-20T13:11:03Z

Page créée avec « '''YAML''', acronyme récursif de '''YAML Ain't Markup Language''', est un format de représentation de données par sérialisation Unicode. Il rep... »

Nouvelle page

'''YAML''', acronyme récursif de '''YAML Ain't [[Langage de balisage|Markup Language]]''', est un format de représentation de données par sérialisation Unicode. Il reprend des concepts d'autres langages comme [[Extensible Markup Language|XML]], ou encore du format de message électronique tel que documenté par RFC 2822<ref>http://www.ietf.org/rfc/rfc2822.txt</ref>. YAML a été proposé par Clark Evans en 2001<ref>[http://tech.groups.yahoo.com/group/sml-dev/message/4710 YAML Draft 0.1], Clark Evans, 11 mai 2001, Yahoo! Tech groups: sml-dev</ref>, et implémenté par ses soins ainsi que par Brian Ingerson et Oren Ben-Kiki.

== Caractéristiques ==
L'idée de fond de YAML est que toute donnée peut être représentée par une combinaison de listes, tableaux (de hachage) et données scalaires. YAML décrit ces formes de données (les ''représentations YAML''), ainsi qu'une syntaxe pour présenter ces données sous la forme d'un flux de caractères (le ''flux YAML'').

Une application informatique passe du flux YAML à la représentation YAML par l'opération de ''chargement'' (anglais ''load''). Elle passe de la représentation au flux par l'opération de ''déchargement'' (anglais ''dump'').

La syntaxe du flux YAML est relativement simple et efficace, moins verbeuse que du [[XML]], moins compacte que du [[Comma separated values|CSV]], et a été établie de sorte qu'elle soit le plus lisible possible par des humains, tout en pouvant être mise en correspondance facilement avec les types de données précités, communs dans les langages de haut niveau. À ces langages il emprunte certaines notations.
* Les commentaires sont signalés par le signe dièse (<code>#</code>) et se prolongent sur toute la ligne.
* Une valeur nulle s'écrit avec le caractère tilde (<code>~</code>)
* Il est possible d'inclure une syntaxe [[JSON]] dans une syntaxe YAML.
* Les items de listes sont dénotés par le tiret (<code>-</code>), suivi d'un espace, à raison d'un item par ligne.
* Les tableaux sont de la forme ''clé: valeur'', soit à raison d'un couple par ligne.
* Les scalaires peuvent être entourés de guillemets doubles (<code>"</code>), ou simples (<code>'</code>), ou encore être représentés par un bloc indenté avec des modificateurs facultatifs pour conserver (<code>|</code>) ou éliminer (<code>></code>) les retours à la ligne.
* Plusieurs documents rassemblés dans un seul fichier sont séparés par trois traits d'union (<code>---</code>) ; trois points (<code>...</code>) optionnels marquent la fin d'un document dans un fichier.
* Les nœuds répétés sont initialement signalés par une esperluette (<code>&</code>) puis sont référencés avec un astérisque (<code>*</code>) ; [[JSON]], un langage concurrent de YAML, est compatible avec la syntaxe de [[JavaScript]] mais ne supporte pas cette notion de référence.
* L'indentation, par des espaces, manifeste une arborescence.
* Il est possible de préciser le type (anglais ''Tag'') d'une donnée. Cependant, cette précision n'opère aucune contrainte, et fonctionne plutôt comme un marquage, ou une modélisation.
* Un fichier YAML est analysable en une seule passe de lecture.

La syntaxe YAML se distingue de JSON par le fait qu'il se veut plus facilement lisible par une personne. Il se distingue du XML par le fait qu'il s'intéresse d'abord à la sérialisation de données, et moins à la documentation.

== Exemples ==

=== Listes ===

<syntaxhighlight lang="yaml">
--- # Films préférés, format bloc
- Casablanca
- Bourgogne Casablanca
- La Règle du jeu
- Titanic
--- # Listes de courses, format linéaire
[lait, pain, œufs]
</syntaxhighlight>

=== Tableaux associatifs ===

<syntaxhighlight lang="yaml">
--- # bloc
nom: Paul Dupond
age: 33
--- # linéaire
{nom: Paul Dupond, age: 33}
</syntaxhighlight>

=== Blocs de mise en forme ===

==== Nouvelles lignes conservées ====

<syntaxhighlight lang="yaml">
--- |
There was a young fellow of Warwick
Who had reason for feeling euphoric
For he could, by election
Have triune erection
Ionic, Corinthian, and Doric
</syntaxhighlight>

==== Nouvelles lignes rassemblées ====

<syntaxhighlight lang="yaml">
--- >
Le texte ainsi
séparé sera ensuite
rassemblé sur
une seule ligne

Une ligne vide
signale un nouveau
paragraphe
</syntaxhighlight>

=== Listes de tableaux associatifs ===

<syntaxhighlight lang="yaml">
- {name: Paul Dupond, age: 33}
-
name: Marie Dupont
age: 27
</syntaxhighlight>

=== Tableaux de listes ===

<syntaxhighlight lang="yaml">
homme: [Paul Dupond, Pierre Dubois]
femme:
- Marie Dupont
- Susanne Didier
- Jean Michel
</syntaxhighlight>

== Références ==
<references/>

Yaml - Historique des versions

Didier : Page créée avec « '''YAML''', acronyme récursif de '''YAML Ain't Markup Language''', est un format de représentation de données par sérialisation Unicode. Il rep... »

Didier : Page créée avec « '''YAML''', acronyme récursif de '''YAML Ain't Markup Language''', est un format de représentation de données par sérialisation Unicode. Il rep... »