YAML - Einrückung und Trennung

Einrückung und Trennung sind zwei Hauptkonzepte, wenn Sie eine Programmiersprache lernen. In diesem Kapitel werden diese beiden Konzepte im Zusammenhang mit YAML ausführlich behandelt.

Einrückung von YAML

YAML enthält keine obligatorischen Leerzeichen. Darüber hinaus besteht keine Notwendigkeit, konsistent zu sein. Die gültige YAML-Einrückung wird unten angezeigt -

a:
   b:
      - c
      -  d
      - e
f:
      "ghi"
  • Beachten Sie beim Arbeiten mit Einrückungen in YAML die folgenden Regeln: Flussblöcke müssen mit mindestens einigen Leerzeichen mit der umgebenden aktuellen Blockebene vorgesehen sein.

  • Der Flussinhalt von YAML umfasst mehrere Zeilen. Der Beginn des Flow-Inhalts beginnt mit{ oder [.

  • Blocklistenelemente enthalten denselben Einzug wie die umgebende Blockebene, da - als Teil des Einzugs betrachtet wird.

Beispiel für einen beabsichtigten Block

Beachten Sie den folgenden Code, der Einrückungen mit Beispielen zeigt -

--- !clarkevans.com/^invoice
invoice: 34843
date   : 2001-01-23
bill-to: &id001
   given  : Chris
   family : Dumars
   address:
      lines: |
            458 Walkman Dr.
            Suite #292
      city    : Royal Oak
      state   : MI
      postal  : 48046
ship-to: *id001
product:
    - sku         : BL394D
      quantity    : 4
      description : Basketball
      price       : 450.00
   - sku         : BL4438H
      quantity    : 1
      description : Super Hoop
      price       : 2392.00
tax  : 251.42
total: 4443.52
comments: >
    Late afternoon is best.
    Backup contact is Nancy
    Billsmer @ 338-4338.

Trennung von Saiten

Zeichenfolgen werden durch Zeichenfolgen in doppelten Anführungszeichen getrennt. Wenn Sie die Zeilenumbruchzeichen in einer bestimmten Zeichenfolge maskieren, wird diese vollständig entfernt und in einen Leerzeichenwert übersetzt.

Beispiel

In diesem Beispiel haben wir uns auf die Auflistung von Tieren konzentriert, die als Array-Struktur mit dem Datentyp der Zeichenfolge aufgeführt sind. Jedes neue Element wird mit einem Bindestrich als Präfix aufgeführt.

-
 - Cat
 - Dog
 - Goldfish
-
 - Python
 - Lion
 - Tiger

Ein weiteres Beispiel zur Erläuterung der Zeichenfolgendarstellung in YAML ist unten aufgeführt.

errors:
      messages:
         already_confirmed: "was already confirmed, please try signing in"
         confirmation_period_expired: "needs to be confirmed within %{period}, please request a new one"
         expired: "has expired, please request a new one"
         not_found: "not found"
         not_locked: "was not locked"
         not_saved:
            one: "1 error prohibited this %{resource} from being saved:"
            other: "%{count} errors prohibited this %{resource} from being saved:"

Dieses Beispiel bezieht sich auf die Fehlermeldungen, die ein Benutzer verwenden kann, indem er nur den Schlüsselaspekt erwähnt und die Werte entsprechend abruft. Dieses Muster von YAML folgt der Struktur von JSON, die von Benutzern verstanden werden kann, die neu in YAML sind.