Building/docs/troubleshooting.md

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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