# Решение типовых проблем

## Нет предпросмотра

- Проверьте, что установлен Tinymist.
- Откройте весь каталог проекта, а не отдельный файл.
- Откройте `main.typ` и повторно запустите `Typst Preview`.
- Проверьте, что Typst доступен командой `typst --version`.

## PDF не собирается после добавления изображения

- Используйте прямые слеши `/`.
- Проверьте имя и расширение файла.
- Пользовательские материалы должны находиться в `assets/`.
- Для обычной сборки не указывайте приватные пути вручную: заглушки подключаются автоматически.

## Не собирается PDF после включения приватных данных

- Проверьте, что рядом с `main.typ` находится папка `.private` и файл `.private/settings.typ`.
- Включайте `true` только у тех изображений, которые уже существуют в `.private`.
- Имена PNG сотрудников берутся из публичного справочника и перечислены в [инструкции](private-assets.md#справочник-сотрудников).
- Если подпись ещё не получена, удалите её запись из `settings.signatures` или укажите `enabled: false` — строка подписи останется пустой, а сборка продолжится.
- Чтобы полностью исключить `.private` из проверки, верните `#let use-private-assets = false`.

## Красное подчёркивание правильного слова

Нажмите `Ctrl+.` и добавьте слово в workspace dictionary. Не добавляйте опечатки: настройка синхронизируется со всей командой.

## Изменения коллег не загружаются

Откройте Source Control и выполните Pull или Sync Changes. Если VS Code сообщает о конфликте, следуйте инструкции [Git для авторов](git.md#конфликт).

## Исчез каталог `.template/`

Он скрыт намеренно настройкой `files.exclude`. Это не удаление. При необходимости временно отключите скрытие в Workspace Settings.

## Не вижу примеры и инструкции

Публичная документация находится в видимом каталоге `docs/`. Если он скрыт, проверьте собственные настройки `files.exclude`: шаблон не скрывает `docs/`.