Initial commit
This commit is contained in:
commit
c534d5ce80
163 files changed
+11500
No files matched your search
@@ -0,0 +1,42 @@
|
||||
# Модуль: Публичные примеры документов
|
||||
|
||||
**Ответственность**: хранит исполняемую документацию четырёх профилей и источник безопасной установки выбранного типа.
|
||||
**Расположение**: `docs/examples/`
|
||||
|
||||
## Публичный интерфейс
|
||||
|
||||
| Каталог | Назначение |
|
||||
|---------|------------|
|
||||
| `documents/report/` | Полный отчёт с главами, bibliography и appendix |
|
||||
| `documents/letter/` | Деловое письмо |
|
||||
| `documents/commercial-offer/` | Технико-коммерческое предложение |
|
||||
| `documents/contract/` | Договор |
|
||||
| `formatting/` | Каталог рисунков, таблиц, формул, ссылок и списков |
|
||||
| `private/settings.typ` | Безопасный полный пример private settings без PNG |
|
||||
|
||||
## Зависимости
|
||||
|
||||
| Модуль | Что использует |
|
||||
|--------|----------------|
|
||||
| `/.template/lib/index.typ` | Только публичный фасад |
|
||||
| `use-starter.ps1` | Backup и копирование примера в корень |
|
||||
| Presentation profiles | Реальный layout каждого вида документа |
|
||||
|
||||
## Инварианты
|
||||
|
||||
- Каждый `main.typ` компилируется непосредственно из своего каталога.
|
||||
- Тот же каталог компилируется после копирования в корень.
|
||||
- Каждый пример явно показывает `company-id`, `document-mode`, `use-private-assets`, profile metadata и media policy.
|
||||
- Public example не зависит от `.template/development/`.
|
||||
- Formatting guide содержит пояснения рядом с копируемыми блоками.
|
||||
- Выбор типа создаёт backup до замены пользовательских файлов.
|
||||
|
||||
## Намеренно НЕ обрабатывает
|
||||
|
||||
- Обратную совместимость со старыми starters.
|
||||
- Синхронизацию уже изменённого примера с пользовательским fork.
|
||||
- Юридическую корректность демонстрационного договора.
|
||||
|
||||
## Заметки для агента
|
||||
|
||||
> Не создавайте отдельную showcase-копию: публичный пример должен одновременно быть тестовым fixture и источником установки. Изменение API считается завершённым только после обновления всех четырёх `main.typ` и formatting guide.
|
||||
Reference in new issue
Block a user