vscode.md 6.4 KB
Настройка VS Code
Открывайте папку целиком
Настройки проекта работают только при открытии корневой папки. В левой панели должны быть видны main.typ, chapters/, assets/ и docs/.
Рекомендации расширений
VS Code читает .vscode/extensions.json и предлагает командные расширения. Откройте Extensions (Ctrl+Shift+X), введите @recommended и установите рекомендации рабочей области.
Typst Typewriter и Zotst являются внутренними расширениями. Получите их .vsix у сопровождающего, затем выполните Ctrl+Shift+P → Extensions: Install from VSIX.
| Расширение | Для чего нужно | Ссылка или ID |
|---|---|---|
| Bookmarks | Пометки и быстрые переходы по большому документу | Marketplace |
| Code Spell Checker | Проверка орфографии | Marketplace |
| Russian — Code Spell Checker | Русский словарь для проверки | Marketplace |
| Russian Language Pack | Русский интерфейс VS Code | Marketplace |
| Tinymist Typst | Подсказки, диагностика и живой предпросмотр | Marketplace |
| TODO Highlight | Выделение TODO, FIXME, ПРОВЕРИТЬ, ВАЖНО |
Marketplace |
| Todo Tree | Общий список пометок по всем главам | Marketplace |
| Git Graph | Наглядная история коммитов, веток и merge | Marketplace |
| Typst Typewriter | Внутренняя панель автора | local.typst-typewriter |
| Zotst — Zotero for Typst | Поиск в Zotero и вставка библиографических ссылок | zotst.zotst |
Полезные команды:
Typst Typewriter: Open Sidebar— открыть панель автора;Zotst: Set References File for This Project— выбратьassets/references.bib;Zotst: Insert Citation from Zotero— найти источник и вставить ссылку;Git Graph: View Git Graph— открыть граф истории документа.
Автосохранение и предпросмотр
Проект задаёт:
"files.autoSave": "afterDelay",
"files.autoSaveDelay": 700
Изменения сохраняются через 700 мс. Для живого просмотра откройте main.typ и запустите команду, содержащую Typst Preview. Пока окно предпросмотра открыто, Tinymist следит за зависимыми главами и обновляет результат.
Если нужен готовый файл, нажмите Ctrl+Shift+B. Режим final, draft или clean-copy выбирается в начале единственного main.typ.
Задачи проекта
Откройте Ctrl+Shift+P → Tasks: Run Task:
| Задача | Результат |
|---|---|
Scientia: собрать PDF |
Собирает текущий main.typ в document.pdf |
Scientia: выбрать тип документа |
Устанавливает пример отчёта, письма, ТКП или договора |
Scientia: собрать учебный пример |
Собирает выбранный пример из docs/examples/ |
Та же задача сборки используется и с приватными изображениями. Скопируйте .private, включите use-private-assets = true в main.typ и запускайте обычный предпросмотр или Ctrl+Shift+B.
Проверка орфографии
Code Spell Checker настроен на русский и английский для Typst, Markdown и BibTeX. Неизвестное корректное слово добавляйте через лампочку → Add Word to Workspace Settings, только если оно действительно должно использоваться всей командой.
Пометки в тексте
Используйте комментарии:
// TODO: добавить источник
// ПРОВЕРИТЬ: согласовать значение с заказчиком
// ВАЖНО: не выпускать без рецензирования
TODO Highlight выделит строку, а Todo Tree соберёт все пометки в одной панели.
Скрытые каталоги
.template/, .private/ и .vscode/ скрыты настройкой files.exclude. Публичный каталог docs/ остаётся видимым. Обычно .private достаточно целиком скопировать с заменой. Чтобы изменить смещение подписи вручную, откройте Settings, найдите files.exclude, временно отключите скрытие .private на уровне Workspace и после работы включите его обратно.