Шаблоны
Обновлено 11 ноября 2026
Шаблоны — механизм утилит Calculate, который настраивает конфигурационные файлы без ручного редактирования. Вы описываете «что должно быть» в файле, а утилиты вносят это в существующую конфигурацию: сохраняют ваши остальные настройки, порядок строк, кавычки и комментарии, связывают файл с пакетом и переписывают его заново при каждом обновлении пакета.
Решаются две задачи сразу. Система остаётся актуальной при непрерывном обновлении: пакеты меняют версии и форматы конфигов, а шаблоны подтягивают настройки за собой. И изменения остаются читаемыми: в шаблоне лежит только то, что вы хотели изменить, а не разрозненные правки в десятках файлов /etc/.
Шаблоны задействованы повсюду: при сборке образа, установке системы, первом запуске, обновлении портежей, настройке пакета и входе пользователя в сеанс.
С чего начать
- Быстрый старт: первый шаблон за пять минут — три законченных примера с проверкой результата.
- Синтаксис шаблона — заголовок, переменные, условия, функции, префиксы
!,+,-. - Форматы конфигурационных файлов — какой формат выбрать и чем они отличаются.
Справочники
- Полное руководство по шаблонам Calculate — справочник в стиле man: весь синтаксис одним файлом, управляющие элементы, правила объединения, все форматы и все функции шаблонов с примерами.
- Полный справочник форматов — все 29 имён format= с поведением и примерами из дерева calculate.
- Параметры заголовка — отдельные списки для файла и для директории: они разные.
- Переменные шаблонов — как посмотреть переменные, где они хранятся и чем отличаются calculate.env от ini.env.
Углублённые темы
- Директории-шаблоны и слои хранения — .calculate_directory, приоритет репозитория, /var/calculate/templates и файлы *.clt, каталоги событий вида N_ac_* и пример инструмента, который сам создаёт шаблоны (cl-kernel).
- Кто и когда налагает шаблоны — карта событий и матрица ac_*-переменных, а также избирательное отключение шаблонов для отдельных пакетов (cl_setup_skip_merge, cl_setup_skip_patch, cl_setup_skip_profile, cl_setup_skip_sync).
- Шаблон молча не сработал: диагностика — шесть типичных причин.
- Жизнь файла после шаблона — владение файлом, protected,
dispatch-conf, корректное удаление. - Свои функции в оверлее — scripts/functions и протокол возврата.
- Шаблон рядом с файлом: .clt — когда шаблон не нужно переносить в /var/calculate/templates.