---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/en/project/presets.md
  - https://3y3.dev/ru/project/presets.md
  - href: ru/project/presets.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-07-24T16:17:13.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

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

Пресеты — это наборы [переменных](https://3y3.dev/ru/syntax/vars.md) с разными значениями.

Пресеты используются, чтобы поддерживать несколько вариантов документации с небольшими различиями из одних и тех же исходных файлов. Если в документации есть внутренняя информация, вы можете [разметить контент](https://3y3.dev/ru/syntax/vars.md) и разделить информацию на два пресета: `internal` и `external`. Это упростит работу и ограничит доступ к конфиденциальным данным. Тогда не нужно будет хранить значения переменных в файлах сборки.

Порядок работы с пресетами:
1. Опишите пресеты в файле `presets.yaml`.
1. При сборке укажите название используемого пресета в [параметре ##vars-preset#](../tools/docs/settings#vars-preset).

## Структура {#structure}

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

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

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

## Иерархия файлов пресетов {#hierarchy }

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

{% note tip %}

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

{% endnote %}

#### Пример

```
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.

## Пример локальной сборки с переиспользованием {#reuse}

Чтобы собрать документ, выполните команду:

```
yfm build -i ./<корневой каталог документа> -o ./<директория с итогом сборки> --vars-preset "<имя пресета>"
```

Если в вашем документе используются пресеты переменных, для каждого пресета сборку необходимо запускать отдельно.

Если в документе пресетов переменных нет — флаг `--vars-preset` использовать не нужно. В этом случае документ соберется со значением пресетов `default`.

В директории с итогом сборки появится одна папка с файлами в формате `.html` для выбранного пресета. Если запустить сборку с другими значениями в ту же директорию, файлы перезапишутся.