Пресеты переменных

Пресеты — это наборы переменных с разными значениями.

Пресеты используются, чтобы поддерживать несколько вариантов документации с небольшими различиями из одних и тех же исходных файлов. Например, если документация содержит внутреннюю информацию, вы можете разметить контент соответствующим образом и создать два пресета: internal и external. И вам не понадобится хранить значения переменных в файлах сборки.

Порядок работы с пресетами:

  1. Опишите пресеты в файле presets.yaml.
  2. При сборке укажите название используемого пресета в параметре varsPreset.

Структура

Файл presets.yaml должен содержать пресет default. При вычислении переменных сначала учитываются значения, указанные в default. Затем на них накладываются значения из пресета, переданного при запуске сборки, так как он является приоритетным.

Пременные в пресете указываются в формате <имя переменной>: <значение переменной>.

default:
    position: Волшебник
internal:
    place: Изумрудный город
external:
    place: Страна Оз

Иерархия файлов пресетов

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

Совет

Рекомендуется использовать верхнеуровневые пресеты: наиболее близкие к корню проекта.

Пример

input-folder
|-- .yfm
|-- toc.yaml
|-- presets.yaml # файл 2
|-- index.yaml
|-- quickstart.md
|-- pages
    |-- presets.yaml # файл 1
    |-- faq.md
    |-- how-to.md

При сборке файла faq.md значения переменных, объявленные в файле 1, будут иметь приоритет над файлом 2.
При сборке файла quickstart.md будут учитываться только значения переменных, объявленные в файле 2.