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

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

Проверьте, что установлен 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/.

3.0 KiB Raw Blame History