Учебники

YAML — Основы

Июнь 5, 2018

Теперь, когда у вас есть представление о YAML и его функциях, давайте изучим его основы с помощью синтаксиса и других операций. Помните, что YAML включает в себя удобочитаемый структурированный формат.

Правила создания файла YAML

Когда вы создаете файл в YAML, вы должны помнить следующие основные правила —

  • YAML чувствителен к регистру

  • Файлы должны иметь расширение .yaml в качестве расширения.

  • YAML не позволяет использовать вкладки при создании файлов YAML; пробелы разрешены вместо

YAML чувствителен к регистру

Файлы должны иметь расширение .yaml в качестве расширения.

YAML не позволяет использовать вкладки при создании файлов YAML; пробелы разрешены вместо

Основные компоненты файла YAML

Основные компоненты YAML описаны ниже —

Обычный блочный формат

Этот формат блока использует дефис + пробел, чтобы начать новый элемент в указанном списке. Обратите внимание на пример, показанный ниже — 

--- # Favorite movies
 - Casablanca
 - North by Northwest
 - The Man Who Wasn't There

Встроенный формат

Встроенный формат отделяется запятой и пробелом, а элементы заключаются в JSON. Обратите внимание на пример, показанный ниже — 

--- # Shopping list
   [milk, groceries, eggs, juice, fruits]

Сложенный текст

Свернутый текст преобразует символы новой строки в пробелы и удаляет начальные пробелы. Обратите внимание на пример, показанный ниже — 

- {name: John Smith, age: 33}
- name: Mary Smith
  age: 27

Структура, которая следует всем основным соглашениям YAML, показана ниже —

Сводка основных элементов YAML приведена здесь: Комментарии в YAML начинаются с символа ( # ).

Комментарии должны быть отделены от других токенов пробелами.

Отступы для пробелов используются для обозначения структуры.

Вкладки не включены в качестве отступа для файлов YAML.

Члены списка обозначаются дефисом ( — ).

Члены списка заключены в квадратные скобки и разделены запятыми.

Ассоциативные массивы представляются с помощью двоеточия ( 🙂 в формате пары ключ-значение. Они заключены в фигурные скобки {} .

Несколько документов с отдельными потоками разделяются 3 дефисами (—).

Повторяющиеся узлы в каждом файле первоначально обозначаются амперсандом ( & ) и звездочкой ( * ) позже.

YAML всегда требует использования двоеточий и запятых в качестве разделителей списков, за которыми следует пробел со скалярными значениями.

Узлы должны быть помечены восклицательным знаком ( ! ) Или двойным восклицательным знаком ( !! ), за которым следует строка, которую можно развернуть в URI или URL.

55
Share: