iskm/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-04-27 15:43:58 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #1403 from payet-s/fix-yaml-fr-typos

Browse Source 
[yaml/fr] Fix typos
This commit is contained in:
ven 2015-10-09 15:33:51 +02:00
commit da1fedc741
1 changed files with 48 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
fr-fr/yaml-fr.html.markdown
View File

@ -8,86 +8,90 @@ lang: fr-fr
Proposé à l'origine par Clark Evans en Mai 2001, YAML est un un format de Proposé à l'origine par Clark Evans en Mai 2001, YAML est un un format de
représentation de données par sérialisation, conçu pour être aisément représentation de données par sérialisation, conçu pour être aisément
éditable et lisible par nous même, les humains. modifiable et lisible par nous-mêmes, les humains.
YAML est plus concis que le XML auquel il est parfois comparé par ceux qui le découvre, plus lisible et clair que le CSV, et emprunte beaucoup au JSON dont il est un parent naturel. Toutefois, YAML emprunte également des idées et concepts de chez Python, et s'intègre bien avec bon nombre de langages. YAML est plus concis que le XML auquel il est parfois comparé par ceux qui le
découvre, plus lisible et clair que le CSV, et emprunte beaucoup au JSON dont
il est un parent naturel. Toutefois, YAML emprunte également des idées et
concepts de Python, et s'intègre bien avec bon nombre de langages.
Contrairement à ce dernier, YAML interdit l'utilisation des tabulations.
```yaml ```yaml
# les Commentaires sont précédés d'un signe "#", comme cette ligne. # Les commentaires sont précédés d'un signe "#", comme cette ligne.
############# #############
# SCALAIRES # # SCALAIRES #
############# #############
# Les scalaires sont l'ensemble des types YAML qui ne sont pas des collections # Les scalaires sont l'ensemble des types YAML qui ne sont pas des collections
# ( listes ou tableaux associatifs ). # (listes ou tableaux associatifs).
# Notre objet root ( racine ), sera une map ( carte ) et englobera # Notre objet root (racine), sera une map (carte) et englobera
# l'intégralité du document. Cette map est l'équivalent d'un dictionnaire, # l'intégralité du document. Cette map est l'équivalent d'un dictionnaire,
# hash ou objet dans d'autres langages. # hash ou objet dans d'autres langages.
clé: valeur clé: valeur
aurtre_clé: une autre valeur autre_clé: une autre valeur
valeur_numérique: 100 valeur_numérique: 100
notation_scientifique: 1e+12 notation_scientifique: 1e+12
boolean: true booléen: true
valeur_null: null valeur_null: null
clé avec espaces: valeur clé avec espaces: valeur
# Bien qu'il ne soit pas nécessaire d'enfermer les chaînes de caractères # Bien qu'il ne soit pas nécessaire de mettre les chaînes de caractères
# entre guillemets, cela reste possible, et parfois utile. # entre guillemets, cela reste possible, et parfois utile.
toutefois: "Une chaîne, peut être contenue entre guillemets." toutefois: "Une chaîne, peut être contenue entre guillemets."
"Une clé entre guillemets.": "Utile si on veut utiliser ':' dans la clé." "Une clé entre guillemets.": "Utile si l'on veut utiliser ':' dans la clé."
# Les chaînes couvrant plusieurs lignes, peuvent être écrites au choix, # Les chaînes couvrant plusieurs lignes, peuvent être écrites au choix,
# comme un 'bloc littéral' ( avec | ) ou bien 'bloc replié' avec ( > ). # comme un "bloc littéral" (avec '|') ou bien un "bloc replié" (avec '>').
bloc_littéral: | bloc_littéral: |
Tout ce bloc de texte sera la valeur de la clé 'bloc_littéral', Tout ce bloc de texte sera la valeur de la clé "bloc_littéral",
avec préservation des retours à la ligne. ( chaque ligne vide à avec préservation des retours à la ligne.
l'intérieur du même bloc, sera remplacée par "\n\n" )
Le littéral continue jusqu'à ce que l'indentation soit annulée. Le littéral continue jusqu'à ce que l'indentation soit annulée.
Toutes lignes qui serait "d'avantage indentées" conservent leur Toutes lignes qui seraient "davantage indentées" conservent leur
indentation, constituée de 4 espaces. indentation, constituée de 4 espaces.
bloc_replié: > bloc_replié: >
Tout ce bloc de texte sera la valeur de la clé 'bloc_replié', mais Tout ce bloc de texte sera la valeur de la clé "bloc_replié", mais
cette fois ci, toutes les nouvelles lignes deviendront un simple espace. cette fois-ci, toutes les nouvelles lignes deviendront un simple espace.
Les lignes vides, comme ci-dessus, seront converties en caractère "\n". Les lignes vides, comme ci-dessus, seront converties en caractère de
nouvelle ligne.
Les lignes 'plus-indentées' gardent leurs retours à la ligne - Les lignes "plus-indentées" gardent leurs retours à la ligne -
ce texte apparaîtra sur deux lignes. ce texte apparaîtra sur deux lignes.
############### ###############
# COLLECTIONS # # COLLECTIONS #
############### ###############
# l'Imbrication est créée par indentation. # L'imbrication est créée par indentation.
une_map_imbriquée: une_map_imbriquée:
clé: valeur clé: valeur
autre_clé: autre valeur autre_clé: autre valeur
autre_map_imbriquée: autre_map_imbriquée:
bonjour: bonjour bonjour: bonjour
# les Clés des Maps ne sont pas nécessairement des chaînes de caractères. # Les clés des maps ne sont pas nécessairement des chaînes de caractères.
0.25: une clé de type float 0.25: une clé de type flottant
# les Clés peuvent également être des objets s'étendant sur plusieurs lignes, # Les clés peuvent également être des objets s'étendant sur plusieurs lignes,
# en utilisant le signe "?" pour indiquer le début de la clé. # en utilisant le signe "?" pour indiquer le début de la clé.
? | ? |
ceci est une Clé ceci est une clé
sur de multiples lignes sur de multiples lignes
: et ceci est sa Valeur : et ceci est sa valeur
# YAML autorise aussi l'usage des collections à l'intérieur des clés, # YAML autorise aussi l'usage des collections à l'intérieur des clés,
# mais certains langages de programmation ne le tolère pas si bien. # mais certains langages de programmation ne le tolère pas si bien.
# les Séquences (équivalent des listes ou tableaux) ressemblent à cela: # Les séquences (équivalent des listes ou tableaux) ressemblent à cela :
une_séquence: une_séquence:
- Item 1 - Objet 1
- Item 2 - Objet 2
- 0.5 # les séquences peuvent contenir des types variés. - 0.5 # les séquences peuvent contenir des types variés.
- Item 4 - Objet 4
- clé: valeur - clé: valeur
autre_clé: autre_valeur autre_clé: autre_valeur
- -
@ -99,22 +103,22 @@ une_séquence:
json_map: {"clé": "valeur"} json_map: {"clé": "valeur"}
json_seq: [1, 2, 3, "soleil"] json_seq: [1, 2, 3, "soleil"]
################################# ################################
# AUTRES FONCTIONNALITÉES YAML # # AUTRES FONCTIONNALITÉES YAML #
################################# ################################
# YAML possède une fonctionnalité fort utile nommée 'ancres'. Celle-ci # YAML possède une fonctionnalité fort utile nommée "ancres". Celle-ci
# vous permet de dupliquer aisément du contenu au sein de votre document. # vous permet de dupliquer aisément du contenu au sein de votre document.
# Les deux clés suivantes auront la même valeur: # Les deux clés suivantes auront la même valeur :
contenu_ancré: &nom_ancre Cette chaîne sera la valeur des deux clés. contenu_ancré: &nom_ancre Cette chaîne sera la valeur des deux clés.
autre_ancre: *nom_ancre autre_ancre: *nom_ancre
# Avec les Tags YAML, vous pouvez explicitement déclarer des types de données. # Avec les tags YAML, vous pouvez explicitement déclarer des types de données.
chaine_explicite: !!str 0.5 chaine_explicite: !!str 0.5
# Certains parsers implémentent des tags spécifiques à d'autres langages, # Certains analyseurs syntaxiques (parsers) implémentent des tags spécifiques à
# comme par exemple le "complex number" de Python. # d'autres langages, comme par exemple celui des nombres complexes de Python.
python_complex_number: !!python/complex 1+2j python_complex_number: !!python/complex 1+2j
##################### #####################
@ -135,14 +139,14 @@ fichier_gif: !!binary |
+f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC +f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs= AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=
# YAML a de même un type "set", qui ressemble à cela: # YAML a de même un type "set", semblable à ceci :
set: set:
? item1 ? item1
? item2 ? item2
? item3 ? item3
# Comme dans Python, les sets ne sont que des maps contenant des valeurs null ; # Comme dans Python, les sets ne sont que des maps contenant des valeurs null ;
# le set précédent est l'équivalent du suivant: # le set précédent est l'équivalent du suivant :
set2: set2:
item1: null item1: null
item2: null item2: null
@ -152,6 +156,6 @@ set2:
Quelques références et outils : Quelques références et outils :
- Doc officielle [YAML 1.2](http://www.yaml.org/spec/1.2/spec.html) *anglais*, - Documentation officielle [YAML 1.2](http://www.yaml.org/spec/1.2/spec.html) *anglais*,
- Une [Introduction à YAML](http://sweetohm.net/html/introduction-yaml.html) très bien construite et claire, - Une [Introduction à YAML](http://sweetohm.net/html/introduction-yaml.html) très bien construite et claire,
- Un outil pour tester [live](http://yaml-online-parser.appspot.com/) la syntaxe YAML, avec des exemples. - Un outil pour tester [en ligne](http://yaml-online-parser.appspot.com/) la syntaxe YAML, avec des exemples.