40 lines
3.0 KiB
Markdown
40 lines
3.0 KiB
Markdown
# Решение типовых проблем
|
|
|
|
## Нет предпросмотра
|
|
|
|
- Проверьте, что установлен 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/`.
|