Initial commit
This commit is contained in:
commit
41d230d524
163 files changed
+11500
No files matched your search
@@ -0,0 +1,42 @@
|
||||
# Модуль: Рабочее пространство автора
|
||||
|
||||
**Ответственность**: предоставляет один понятный входной файл и отделяет пользовательский текст от реализации.
|
||||
**Расположение**: `main.typ`, `chapters/`, `assets/`, `docs/`
|
||||
|
||||
## Публичный интерфейс
|
||||
|
||||
| Элемент | Тип | Описание |
|
||||
|---------|-----|----------|
|
||||
| `main.typ` | entrypoint | Компания, режим, metadata, ресурсы и порядок `#include` |
|
||||
| `document-mode` | строка | `final`, `draft` или `clean-copy` |
|
||||
| `chapters/` | каталог | Текстовые разделы документа |
|
||||
| `assets/` | каталог | Рисунки, CSV/TSV, bibliography и другие материалы |
|
||||
| `docs/` | каталог | Публичная справка и компилируемые примеры |
|
||||
|
||||
## Зависимости
|
||||
|
||||
| Модуль | Что использует |
|
||||
|--------|----------------|
|
||||
| `.template/lib/index.typ` | Единственный Typst facade import |
|
||||
| `chapters/*.typ` | Явно перечисленное содержимое |
|
||||
| `assets/*` | Пользовательские paths |
|
||||
| `.private/settings.typ` | Только при явном `use-private-assets = true` |
|
||||
|
||||
## Инварианты
|
||||
|
||||
- В корне существует только один Typst entrypoint `main.typ`.
|
||||
- Все ежедневные параметры и порядок глав видны в одном файле.
|
||||
- Режимы не представлены отдельными файлами.
|
||||
- `docs/` не скрыт настройками VS Code.
|
||||
- Автор не обязан открывать `.template/` для первого PDF.
|
||||
- Generated PDF и `.private/` не попадают в Git.
|
||||
|
||||
## Намеренно НЕ обрабатывает
|
||||
|
||||
- Layout renderer и profile validation.
|
||||
- Разработку нового вида документа.
|
||||
- Хранение настоящих подписей.
|
||||
|
||||
## Заметки для агента
|
||||
|
||||
> Корень является пользовательским интерфейсом. Новый обязательный параметр добавляйте в `main.typ` и public examples с вариантом в комментарии. Не создавайте дополнительный entrypoint ради режима сборки.
|
||||
Reference in new issue
Block a user