En YAML, comment puis-je rompre une chaîne de caractères sur plusieurs lignes?

Il y a 5 6 NEUF (ou 63*, selon la façon de compter) les différentes façons d'écrire plusieurs lignes de chaînes en YAML.

TL;DR

• Habituellement, vous voulez >:

  key: >
    Your long
    string here.
  

• Si vous voulez que les retours à la ligne (pour être conservé comme \n dans la chaîne (par exemple, intégré démarque avec des paragraphes), l'utilisation |.

  key: |
    ### Heading
  
    * Bullet
    * Points
  

• Utilisation >- ou |- à la place si vous ne voulez pas un saut de ligne ajoutée à la fin.

• Si vous avez besoin de lignes de séparation dans le milieu des mots ou littéralement type de retours à la ligne (comme \n, utilisez les guillemets à la place:

  key: "Antidisestab\
   lishmentarianism.\n\nGet on it."
  

• YAML est fou.

Bloc scalaire styles (>, |)

Ceux-ci permettent à des personnages comme \ et " sans s'échapper, et ajouter une nouvelle ligne (\n) à la fin de votre chaîne.

> Style plié supprime les retours à la ligne unique au sein de la chaîne (mais s'y ajoute à la fin, et la convertit en double retours à la ligne pour les célibataires):

Key: >
  this is my very very very
  long string

→ this is my very very very long string\n

| Style littéral transforme chaque saut de ligne à l'intérieur de la chaîne dans un littéral de retour à la ligne, et ajoute à la fin:

Key: |
  this is my very very very 
  long string

→ this is my very very very\nlong string\n

Voici la définition officielle de l' YAML Spec 1.2

Scalaire contenu peut être écrit dans le bloc de la notation, à l'aide d'un style littéral (indiqué par “|”) où tous les sauts de ligne sont importants. Alternativement, elles peuvent être écrites avec le style plié (désignés par le symbole “>”) où chaque saut de ligne est plié à un espace, sauf si elle se termine un vide ou un plus en retrait de la ligne.

Bloc de styles avec bloc partant de l'indicateur (>-, |-, >+, |+)

Vous pouvez contrôler la gestion de la version définitive de la nouvelle ligne à la corde, et toute fuite des lignes vides (\n\n) par l'ajout d'un bloc partant de l'indicateur caractère:

• >, |: "clip": maintenir la ligne d'alimentation, supprimer la fin des lignes vides.
• >-, |-: "la bande": supprimer le saut de ligne, supprimer la fin des lignes vides.
• >+, |+: "garder": maintenir la ligne d'alimentation, garder de fuite des lignes vides.

"Flux" scalaire styles (, ", ')

Ceux-ci ont limité leur fuite, et de construire une ligne de chaîne à n caractères de nouvelle ligne. Ils peuvent commencer sur la même ligne que la clé, ou avec d'autres retours à la ligne en premier.

style ordinaire (pas de fuite, pas de # ou : combinaisons, des limites sur le premier caractère):

Key: this is my very very very 
  long string

double-cité de style (\ et " doivent être échappés par \, les nouvelles lignes peuvent être insérées avec un littéral \n séquence, les lignes peuvent être concaténés, sans espaces, avec fuite de \):

Key: "this is my very very \"very\" loooo\
  ng string.\n\nLove, YAML."

→ "this is my very very \"very\" loooong string.\n\nLove, YAML."

une seule cité de style (littérale ' doit être doublé, pas de caractères spéciaux, peut être utile pour exprimer les chaînes de caractères commençant avec les guillemets):

Key: 'this is my very very "very"
  long string, isn''t it.'

→ "this is my very very \"very\" long string, isn't it."

Résumé

Dans ce tableau, _ signifie space character. \n signifie "caractère de saut de ligne" (\n en JavaScript), sauf pour le "en-ligne des retours à la ligne sur la ligne", où il signifie littéralement une barre oblique et un n).

                      >     |            "     '     >-     >+     |-     |+
------------------------- | ------ | ----- | ----- | ----- | ------ | ------ | ------ | ------  
Trailing spaces   | Kept | Kept |     |     |     | Kept | Kept | Kept | Kept
Single newline => | _    | \n   | _   | _   | _   | _    |  _   | \n   | \n
Double newline => | \n   | \n\n | \n  | \n  | \n  | \n   |  \n  | \n\n | \n\n
Final newline  => | \n   | \n   |     |     |     |      |  \n  |      | \n
Final dbl nl's => |      |      |     |     |     |      | Kept |      | Kept  
In-line newlines  | No   | No   | No  | \n  | No  | No   | No   | No   | No
Spaceless newlines| No   | No   | No  | \   | No  | No   | No   | No   | No 
Single quote      | '    | '    | '   | '   | ''  | '    | '    | '    | '
Double quote      | "    | "    | "   | \"  | "   | "    | "    | "    | "
Backslash         | \    | \    | \   | \\  | \   | \    | \    | \    | \
" #", ": "        | Ok   | Ok   | No  | Ok  | Ok  | Ok   | Ok   | Ok   | Ok
Can start on same | No   | No   | Yes | Yes | Yes | No   | No   | No   | No
line as key       |

Exemples

Note les espaces à droite sur la ligne avant "des espaces."

- >
  very "long"
  'string' with

  paragraph gap, \n and        
  spaces.
- | 
  very "long"
  'string' with

  paragraph gap, \n and        
  spaces.
- very "long"
  'string' with

  paragraph gap, \n and        
  spaces.
- "very \"long\"
  'string' with

  paragraph gap, \n and        
  s\
  p\
  a\
  c\
  e\
  s."
- 'very "long"
  ''string'' with

  paragraph gap, \n and        
  spaces.'
- >- 
  very "long"
  'string' with

  paragraph gap, \n and        
  spaces.

[
  "very \"long\" 'string' with\nparagraph gap, \\n and         spaces.\n", 
  "very \"long\"\n'string' with\n\nparagraph gap, \\n and        \nspaces.\n", 
  "very \"long\" 'string' with\nparagraph gap, \\n and spaces.", 
  "very \"long\" 'string' with\nparagraph gap, \n and spaces.", 
  "very \"long\" 'string' with\nparagraph gap, \\n and spaces.", 
  "very \"long\" 'string' with\nparagraph gap, \\n and         spaces."
]

Bloc de styles d'indentation indicateurs

Juste au cas ci-dessus n'est pas assez pour vous, vous pouvez ajouter un "l'indentation d'un bloc indicateur" (après votre bloc partant de l'indicateur, si vous en avez un):

- >8
        My long string
        starts over here
- |+1
 This one
 starts here

Additif

Si vous insérez des espaces supplémentaires au début de ne pas les premières lignes dans le style Plié, ils seront conservés, avec un bonus de saut de ligne. Ce n'est pas le cas avec les styles de flux:

- >
    my long
      string
- my long
    string

→ ["my long\n string\n", "my long string"]

Je ne peux même pas.

*2 bloc de styles, chacun avec 2 bloc possible partant des indicateurs (ou aucun), et avec 9 possible indentation indicateurs (ou aucun), 1 style ordinaire et 2, cité styles: 2 x (2 + 1) x (9 + 1) + 1 + 2 = 63

Partie de cette information a également été résumées ici.

1. Bloc de Notation: nouvelles lignes devenues des espaces et des sauts de ligne supplémentaires après le bloc sont supprimés

---
# Note: It has 1 new line after the string
content:
    Arbitrary free text
    over multiple lines stopping
    after indentation changes...

...

Équivalent JSON

{
 "content": "Arbitrary free text over multiple lines stopping after indentation changes..."
}

2. Block littéral Scalaire: Un Littéral Bloc Scalaire | comprendra les sauts de ligne et les espaces de fin. mais supprime supplémentaire

retours à la ligne après le bloc.

---
# After string we have 2 spaces and 2 new lines
content1: |
 Arbitrary free text
 over "multiple lines" stopping
 after indentation changes...  


...

Équivalent JSON

{
 "content1": "Arbitrary free text\nover \"multiple lines\" stopping\nafter indentation changes...  \n"
}

3. + indicateur avec Littérale Bloc Scalaire: conserver un surplus de retours à la ligne après le blocage

---
# After string we have 2 new lines
plain: |+
 This unquoted scalar
 spans many lines.


...

Équivalent JSON

{
 "plain": "This unquoted scalar\nspans many lines.\n\n\n"
}

4. – indicateur avec Littérale Bloc Scalaire: – signifie que le saut de ligne à la fin de la chaîne est supprimée.

---
# After string we have 2 new lines
plain: |-
 This unquoted scalar
 spans many lines.


...

Équivalent JSON

{
 "plain": "This unquoted scalar\nspans many lines."
}

5. Plié Bloc Scalaire(>):

se plier aux espaces, retours à la ligne, mais supprime supplémentaire des retours à la ligne après le bloc.

---
folded_newlines: >
 this is really a
 single line of text
 despite appearances


...

Équivalent JSON

{
 "fold_newlines": "this is really a single line of text despite appearances\n"
}

de plus, vous pouvez consulter mon blog

Pour concaténer les longues lignes sans les espaces, l'utilisation des guillemets et de fuir les retours à la ligne avec des barres obliques inverses:

key: "Loremipsumdolorsitamet,consecteturadipiscingelit,seddoeiusmodtemp\
  orincididuntutlaboreetdoloremagnaaliqua."

(Merci @Tobia)

Pour les situations étaient la chaîne peut contenir des espaces ou pas, je préfère les guillemets doubles et de continuation de ligne avec des barres obliques inverses:

key: "String \
  with long c\
  ontent"

Mais remarque à propos de l'écueil pour le cas d'un prolongement de la ligne commence par un espace, il doit être échappés (car il sera dépouillé ailleurs):

key: "String\
  \ with lon\
  g content"

Si la chaîne contient des sauts de ligne, ce doit être écrit en C style \n.

Voir aussi cette question.