Wie breche ich eine Zeichenfolge über mehrere Zeilen?

In YAML habe ich eine Zeichenfolge, die sehr lang ist. Ich möchte dies in der 80-Spalten-Ansicht (oder so) meines Editors belassen, daher möchte ich die Zeichenfolge unterbrechen. Wie lautet die Syntax dafür?

Mit anderen Worten, ich habe Folgendes:

Key: 'this is my very very very very very very long string'

und ich möchte dies (oder etwas in diesem Sinne) haben:

Key: 'this is my very very very ' +
     'long string'

Ich möchte Anführungszeichen wie oben verwenden, damit ich nichts innerhalb der Zeichenfolge umgehen muss.

Bei Verwendung des gefalteten Yaml-Stils wird jeder Zeilenumbruch durch ein Leerzeichen ersetzt. Die Einrückung in jeder Zeile wird ignoriert. Am Ende wird ein Zeilenumbruch eingefügt.

Key: >
  This is a very long sentence
  that spans several lines in the YAML
  but which will be rendered as a string
  with only a single carriage return appended to the end.

http://symfony.com/doc/current/components/yaml/yaml_format.html

Sie können den "Block Chomping Indicator" verwenden, um den Zeilenumbruch wie folgt zu beseitigen:

Key: >-
  This is a very long sentence
  that spans several lines in the YAML
  but which will be rendered as a string
  with NO carriage returns.

Es stehen auch andere Steuerungswerkzeuge zur Verfügung (zum Beispiel zum Steuern der Einrückung).

Siehe https://yaml-multiline.info/

Es gibt 5 6 NEUN (oder 63 *, je nachdem, wie Sie zählen) verschiedene Möglichkeiten, mehrzeilige Zeichenfolgen in YAML zu schreiben.

TL; DR

• Normalerweise möchten Sie >:

  key: >
    Your long
    string here.
  

• Wenn Sie möchten, dass die Zeilenumbrüche wie \nin der Zeichenfolge beibehalten werden (z. B. eingebetteter Markdown mit Absätzen), verwenden Sie |.

  key: |
    ### Heading
  
    * Bullet
    * Points
  

• Verwenden Sie >-oder |-stattdessen, wenn am Ende kein Zeilenumbruch angehängt werden soll.

• Wenn Sie Zeilen in der Mitte von Wörtern teilen oder Zeilenumbrüche buchstäblich als eingeben müssen \n, verwenden Sie stattdessen doppelte Anführungszeichen:

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

• YAML ist verrückt.

Block skalare Stile ( >, |)

Diese erlauben Zeichen wie \und "ohne Escapezeichen und fügen \nam Ende Ihrer Zeichenfolge eine neue Zeile ( ) hinzu.

> Der gefaltete Stil entfernt einzelne Zeilenumbrüche innerhalb der Zeichenfolge (fügt jedoch am Ende eine hinzu und konvertiert doppelte Zeilenumbrüche in Singles):

Key: >
  this is my very very very
  long string

→ this is my very very very long string\n

| Der wörtliche Stil verwandelt jede neue Zeile in der Zeichenfolge in eine wörtliche neue Zeile und fügt am Ende eine hinzu:

Key: |
  this is my very very very 
  long string

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

Hier ist die offizielle Definition aus der YAML-Spezifikation 1.2

Skalare Inhalte können in Blocknotation unter Verwendung eines Literalstils (angezeigt durch "|") geschrieben werden, bei dem alle Zeilenumbrüche von Bedeutung sind. Alternativ können sie mit dem gefalteten Stil (mit „>“ gekennzeichnet) geschrieben werden, wobei jeder Zeilenumbruch zu einem Leerzeichen gefaltet wird, es sei denn, er endet mit einer leeren oder einer stärker eingerückten Zeile.

Block Stile mit Block scharrt Indikator ( >-, |-, >+, |+)

Sie können die Behandlung der letzten neuen Zeile in der Zeichenfolge und aller nachfolgenden Leerzeilen ( \n\n) steuern, indem Sie ein Block-Chomping-Indikatorzeichen hinzufügen :

• >, |: "clip": Zeilenvorschub beibehalten, nachgestellte Leerzeilen entfernen.
• >-, |-: "Streifen": Entfernen Sie den Zeilenvorschub, entfernen Sie die nachgestellten Leerzeilen.
• >+, |+: "behalten": Zeilenvorschub beibehalten, Leerzeilen nachziehen.

"Flow" Skalar Arten ( , ", ')

Diese haben ein begrenztes Escapezeichen und erstellen eine einzeilige Zeichenfolge ohne neue Zeilenzeichen. Sie können in derselben Zeile wie der Schlüssel oder zuerst mit zusätzlichen Zeilenumbrüchen beginnen.

einfacher Stil (kein Entkommen, Nein#oder:Kombinationen, Begrenzung des ersten Zeichens):

Key: this is my very very very 
  long string

Stil in doppelten Anführungszeichen (\und"muss\maskiert werden, Zeilenumbrüche können mit einer Literalfolge eingefügt\nwerden, Zeilen können ohne Leerzeichen mit nachgestelltenZeichenverkettet werden\):

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

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

Stil in einfachen Anführungszeichen (Literal'muss verdoppelt werden, keine Sonderzeichen, möglicherweise nützlich, um Zeichenfolgen auszudrücken, die mit doppelten Anführungszeichen beginnen):

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

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

Zusammenfassung

In dieser Tabelle _bedeutet space character. \nbedeutet "Zeilenumbruch" ( \nin JavaScript), mit Ausnahme der Zeile "Zeilenumbruch", in der es wörtlich einen Backslash und ein n bedeutet.

                      >     |            "     '     >-     >+     |-     |+
-------------------------|------|-----|-----|-----|------|------|------|------  
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       |

Beispiele

Beachten Sie die nachgestellten Leerzeichen in der Zeile vor "Leerzeichen".

- >
  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."
]

Blockstile mit Einrückungsindikatoren

Nur für den Fall, dass Ihnen das oben Genannte nicht ausreicht, können Sie einen " Blockeinrückungsindikator " hinzufügen (nach Ihrem Blockzusammensetzungsindikator, falls vorhanden):

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

Nachtrag

Wenn Sie am Anfang von nicht den ersten Zeilen im gefalteten Stil zusätzliche Leerzeichen einfügen, werden diese mit einem Bonus-Zeilenumbruch beibehalten. Dies ist bei Flow-Stilen nicht der Fall:

- >
    my long
      string
- my long
    string

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

Ich kann nicht einmal.

*2 Blockstile mit jeweils 2 möglichen Block-Chomping-Indikatoren (oder keine) und mit 9 möglichen Einrückungsindikatoren (oder keine), 1 einfachen Stil und 2 zitierten Stilen: 2 x (2 + 1) x (9 + 1) + 1 + 2 = 63

Einige dieser Informationen auch zusammengefasst hier .

Zur Erhaltung newlines Verwendung |, zum Beispiel:

|
  This is a very long sentence
  that spans several lines in the YAML
  but which will be rendered as a string
  with newlines preserved.

wird übersetzt in "Dies ist ein sehr langer Satz‌ \ n , der mehrere Zeilen in der YAML‌ \ n umfasst, aber als Zeichenfolge‌ \ n mit beibehaltenen Zeilenumbrüchen gerendert wird . \ n "

1. Blocknotation (einfach, im Flow-Stil, skalar): Zeilenumbrüche werden zu Leerzeichen und zusätzlichen Zeilenumbrüchen, nachdem der Block entfernt wurde

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

...

Äquivalentes JSON

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

2. Literaler Blockskalar: Ein wörtlicher Blockskalar | enthält die Zeilenumbrüche und alle nachgestellten Leerzeichen. entfernt aber extra

Zeilenumbrüche nach dem Block.

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


...

Äquivalentes JSON

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

3. + Indikator mit Literal Block Scalar: Halten Sie zusätzliche Zeilenumbrüche nach dem Block

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


...

Äquivalentes JSON

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

4. - Indikator mit Literal Block Scalar: - bedeutet, dass die neue Zeile am Ende der Zeichenfolge entfernt wird.

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


...

Äquivalentes JSON

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

5. Gefalteter Blockskalar (>):

Faltet Zeilenumbrüche in Leerzeichen und entfernt zusätzliche Zeilenumbrüche nach dem Block.

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


...

Äquivalentes JSON

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

Für mehr kannst du meinen Blog besuchen

Sie werden es vielleicht nicht glauben, aber YAML kann auch mehrzeilige Tasten ausführen:

?
 >
 multi
 line
 key
:
  value

Um lange Zeilen ohne Leerzeichen zu verketten , verwenden Sie doppelte Anführungszeichen und schließen Sie die Zeilenumbrüche mit umgekehrten Schrägstrichen:

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

(Danke @Tobia)

Wenn Sie YAML und Twig für Übersetzungen in Symfony verwenden und mehrzeilige Übersetzungen in Javascript verwenden möchten, wird direkt nach der Übersetzung ein Wagenrücklauf hinzugefügt. Also auch der folgende Code:

var javascriptVariable = "{{- 'key'|trans -}}";

Welches hat die folgende yml Übersetzung:

key: >
    This is a
    multi line 
    translation.

Wird immer noch den folgenden Code in HTML ergeben:

var javascriptVariable = "This is a multi line translation.
";

Das Minuszeichen in Twig löst dies also nicht. Die Lösung besteht darin, dieses Minuszeichen nach dem Größer-als-Zeichen in yml einzufügen:

key: >-
    This is a
    multi line 
    translation.

Wird das richtige Ergebnis haben, mehrzeilige Übersetzung in einer Zeile in Twig:

var javascriptVariable = "This is a multi line translation.";

In Situationen, in denen die Zeichenfolge Leerzeichen enthalten könnte oder nicht, bevorzuge ich doppelte Anführungszeichen und Zeilenfortsetzung mit umgekehrten Schrägstrichen:

key: "String \
  with long c\
  ontent"

Beachten Sie jedoch die Gefahr für den Fall, dass eine Fortsetzungslinie mit einem Leerzeichen beginnt und maskiert werden muss (da sie an anderer Stelle entfernt wird):

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

Wenn die Zeichenfolge Zeilenumbrüche enthält, muss diese im C-Stil geschrieben werden \n.

Siehe auch diese Frage .

Keine der oben genannten Lösungen hat für mich in einer YAML-Datei innerhalb eines Jekyll-Projekts funktioniert. Nachdem ich viele Optionen ausprobiert hatte, wurde mir klar, dass eine HTML-Injection mit <br>auch funktionieren könnte, da am Ende alles in HTML gerendert wird:

Name: | In einem Dorf von La Mancha, an <br>dessen Namen ich mich nicht <br>erinnern möchte.

Zumindest funktioniert es bei mir. Keine Ahnung zu den mit diesem Ansatz verbundenen Problemen.