31 lines
2.9 KiB
Markdown
31 lines
2.9 KiB
Markdown
# ADR-0001: Typst 0.15.1 как минимальная платформа
|
|
|
|
**Дата**: 2026-08-26
|
|
**Статус**: Принято
|
|
|
|
## Контекст
|
|
|
|
Шаблон уже реализован на Typst и использует его counters, introspection, show rules и PDF-рендер. После обновления окружения доступен Typst 0.15.1, который добавляет несколько bibliographies, тип `path` для передачи project-relative ресурсов и более подробные diagnostics. Одновременно 0.15 меняет baseline некоторых layout-элементов, поэтому обновление должно сопровождаться визуальным аудитом.
|
|
|
|
Официальные основания: [changelog Typst 0.15.0](https://typst.app/docs/changelog/0.15.0/), [bibliography](https://typst.app/docs/reference/model/bibliography/), [path](https://typst.app/docs/reference/foundations/path/).
|
|
|
|
## Рассматриваемые варианты
|
|
|
|
1. **Остаться на Typst 0.14.2** — меньше миграционных рисков сейчас, но нет нативных нескольких bibliographies и нового `path`.
|
|
2. **Принять Typst 0.15.1+** — доступны нужные возможности, но требуется новый baseline и контроль будущих обновлений.
|
|
3. **Перейти на LaTeX или Word** — большая экосистема, но фактически требует переписать проверенную вёрстку и усложняет программируемые компоненты.
|
|
|
|
## Решение
|
|
|
|
Выбрали **Typst 0.15.1 как минимальную поддерживаемую версию**, потому что она уже установлена, поддерживает несколько bibliographies и даёт корректную модель передачи путей между пользовательским проектом и библиотекой.
|
|
|
|
Каждое обновление Typst выполняется отдельным изменением: сначала полная компиляционная и визуальная матрица, затем принятие новых snapshots.
|
|
|
|
## Последствия
|
|
|
|
**Становится проще**: тематические и поглавные библиографии, автономное подключение шаблона, диагностика layout convergence.
|
|
|
|
**Становится сложнее**: необходимо контролировать версию CLI и визуальные изменения baseline.
|
|
|
|
**Закрывает дверь на**: поддержку Typst 0.14 и более ранних версий без отдельной compatibility-ветки.
|