Initial commit

docs/troubleshooting.md

@@ -0,0 +1,39 @@
+# Решение типовых проблем
+
+## Нет предпросмотра
+
+- Проверьте, что установлен 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/`.