# Работа с документами

## Один файл настроек

В проекте используется только один входной файл — `main.typ`. В нём находятся данные документа, выбранный режим и порядок глав. Отдельные `draft.typ` и `clean-copy.typ` не нужны.

```typst
#let company-id = "scientia" // "scientia" | "technology" | "too"
#let document-mode = "final" // "final" | "draft" | "clean-copy"
#let use-private-assets = false // true, когда есть настроенная .private
```

- `final` — выпускной документ; приватные подписи и печати показываются при `use-private-assets = true`;
- `draft` — черновик с водяным знаком без реальных подписей;
- `clean-copy` — чистая копия с зарезервированными местами для ручного подписания.

## Виды документов

| Вид | Когда использовать | Готовый исходник |
|-----|--------------------|------------------|
| Отчёт | Технический или научный отчёт с титулом, содержанием, источниками и приложениями | [report/main.typ](examples/documents/report/main.typ) |
| Письмо | Исходящее письмо с адресатом, номером, подписью и перечнем приложений | [letter/main.typ](examples/documents/letter/main.typ) |
| ТКП | Предложение с составом работ, стоимостью, сроками и условиями оплаты | [commercial-offer/main.typ](examples/documents/commercial-offer/main.typ) |
| Договор | Стороны, представители, разделы, реквизиты и приложения | [contract/main.typ](examples/documents/contract/main.typ) |

Самый простой способ выбора — задача VS Code **Scientia: выбрать тип документа**. Она заменяет `main.typ` и `chapters/`, предварительно сохраняя резервную копию в `.private/starter-backups/`.

## Главы

Один крупный смысловой раздел удобно хранить в одном файле:

```text
chapters/
├── 00-introduction.typ
├── 10-methods.typ
├── 20-results.typ
├── 30-discussion.typ
└── 90-conclusion.typ
```

Числовой префикс помогает видеть порядок в проводнике, но сам по себе ничего не подключает. Состав PDF задаётся внизу `main.typ`:

```typst
#include "chapters/00-introduction.typ"
#pagebreak()
#include "chapters/10-methods.typ"
```

## Ресурсы

- изображения — `assets/images/`;
- библиография — `assets/references.bib`;
- таблицы данных — `assets/data/` или непосредственно `assets/`;
- материалы конкретной главы можно хранить в подпапке с понятным именем.

Используйте прямые слеши: `assets/images/section-2.png`. Путь внутри главы считается относительно файла главы, поэтому из `chapters/10-main.typ` изображение обычно открывается как `../assets/images/example.png`.

## Как начать собственный проект

1. Выберите вид документа до начала больших правок.
2. Откройте `main.typ` и проверьте параметры сверху вниз.
3. Переименуйте или создайте главы.
4. Обновите список `#include`.
5. Замените учебные рисунки, таблицы и формулы своими данными.
6. Соберите PDF и сохраните законченную часть отдельным коммитом.