Руководство пользователя Presswork (RU)

Это руководство описывает все функции Presswork с пошаговым обзором каждой области приложения.

1. Обзор

Presswork — профессиональный Markdown-редактор для издательского дела и самиздата. Он сочетает чистое письмо, редакционные инструменты (стиль, синопсис, версии) и профессиональный экспорт (PDF, PDF/X, EPUB, DOCX, HTML, ICML, FDX). Включает Typst для быстрых PDF и поддерживает LaTeX + Ghostscript для сертифицированных PDF/X.

2. Требования и установка

• Включены: Pandoc, Typst (базовый PDF), внутренние движки.
• Опционально (Pro): LaTeX и Ghostscript для сертифицированных PDF/X.

Где проверить:

• Инструменты → Проверка экспорта: проверка и инструкции по установке.

3. Режимы и лицензии (Base / Pro)

• Base: упрощённый интерфейс, быстрый PDF через Typst, меньше опций.
• Pro: PDF/X, preflight, мультиэкспорт, расширенные опции и полный набор редакционных инструментов.
• Быстрое переключение — кнопкой Base/Pro в шапке; полный план и Лицензия — в Настройки → App → Рабочий вид.

4. Основной интерфейс

• Шапка: быстрый доступ к Документу, Инструментам, Экспорту, Виду, лицензии, руководству.
• Редактор: область Markdown с панелью инструментов и горячими клавишами.
• Боковая панель: Outline, Snapshot, Backlink, Scrivener.
• Строка состояния: слова, символы, строка/столбец, цели.

5. Меню «Документы»

• Новый: создаёт новый документ.
• Сохранить MD / Сохранить как…: сохраняет в .md.
• Импорт документа: Word (.docx, .doc), ODT, HTML, Markdown, PDF, ICML, Final Draft. Изображения приходят вместе с текстом: рисунки из документа Word — включая таблицы Excel, вставленные как изображение, — и картинки, встроенные в PDF, извлекаются в папку рядом с импортированным файлом. То, что в PDF является векторным рисунком (а многие диаграммы именно такие), не изображение и извлечь его нельзя.
• Открыть проект: загружает проект по главам.
• Режим структуры: управление главами/порядком.
• Управление проектом: создание/обновление редакционных проектов.
• Печать: печатает текущий документ.
• Версии: история автосохранений и восстановление.

Рекомендуемый порядок:

1. Создайте документ или проект.
2. Сохраняйтесь чаще.
3. Используйте «Версии» для возврата к редакциям.

6. Меню «Инструменты»

• Цели: дневные цели по словам или цели на документ.
• Статистика: динамика письма, темп, сложность, flow.
• Руководство пользователя: встроенное руководство.
• Проверка экспорта: проверяет LaTeX/Ghostscript.
• Command Palette: поиск команд (Ctrl/Cmd + P).
• Анализ стиля: повторы, читаемость, тон, инклюзивность.
• ИИ-ассистент: резюме, переписывание, согласованность.
• Режим Vim: команды Vim.
• Collab: совместные P2P-сессии с быстрым приглашением по ID сессии.
  • Быстрый старт: откройте Инструменты → Collab, укажите имя, создайте или вставьте ID сессии (pw-...) и нажмите «Подключиться».
  • Во время звонка: используйте переключатели микрофона и камеры на плавающей панели; если WebRTC не проходит, настройте WebSocket-релей (presswork-collab-relay-url).
• Тур: экскурсия по специальным форматам.
• Цифровая подпись: подписывает PDF сертификатом (Pro).

7. Меню «Экспорт»

Основные форматы

• PDF (Typst, быстрый)
• PDF/X (LaTeX, сертифицированный)
• PDF-сценарий (Голливуд)
• FDX (Final Draft)
• DOCX / ODT
• EPUB
• HTML
• ICML (InCopy/InDesign)

Опции

• Стиль PDF: выбор PDF-шаблона.
• PDF/X: ICC-профиль, валидация, встроенные шрифты.
• Метки реза/вылеты: параметры печати.
• Метаданные EPUB + обложка.
• Preflight: чек-лист качества и печати.
• История экспорта: журнал экспортов.
• Мультиэкспорт: несколько файлов в один.
• Мультиформатный экспорт: PDF + EPUB + HTML и т. д.
• Экспорт с ресурсами: включает изображения/ресурсы.
• Конвертировать папку: пакетная конвертация.

8. Меню «Вид»

• Режимы: Письмо, Код, Предпросмотр, Страница, Split.
• Язык: 9 языков интерфейса.
• Тема: светлая/тёмная.
• Печатная машинка: активная строка по центру.
• Режим фокуса: скрывает интерфейс (F11).
• Презентация: полноэкранные слайды.
• Доступность: размер текста, контраст, шрифт для дислексии.

9. Панель инструментов редактора

• Форматирование: жирный, курсив, подчёркнутый.
• Заголовки: H1/H2/H3.
• Элементы: ссылки, изображения, код строчный/блочный.
• Списки: маркированные/нумерованные.
• Цитаты.
• Таблицы.
• CriticMarkup: вставка, удаление, комментарий.
• Шаблоны: пресеты вёрстки.
• Метаданные: YAML front matter.
• Snapshot: снимки сцен.
• Синопсис: резюме по главам.

10. Панели боковой панели

• Outline: навигация по разделам.
• Snapshot: управление снимками.
• Backlink: связи между документами.
• Scrivener: главы и drag&drop.
• Scene Navigator: для сценариев.

11. Письмо в Markdown

Базовый синтаксис

• # Заголовок / ## Подзаголовок
• **жирный**, *курсив*
• - список / 1. нумерованный список
• [ссылка](url)
• ![alt](изображение)
• > цитата
• \newpage для разрыва страницы

Советы

• Перетаскивайте изображения.
• Используйте Split или Предпросмотр для контроля вёрстки.

12. Шаблоны

• Готовые шаблоны: доступ с панели инструментов (Tpl).
• Пользовательские шаблоны:
  • Импорт одного файла или папки (меню Шаблоны → «Импортировать файл / Импортировать папку»).
  • Автоматическая классификация по вкладкам: css→UI Kit, xlsx/xls/ods/csv→Business, остальное→Документы.
  • Значок Custom и полная подсказка при наведении (имя + описание).
  • .md: загружаются в редактор.
  • .tex/.pdfx/.pdft: используются как стили экспорта PDF.
  • .xlsx/.xls/.ods/.csv: используются в потоках таблиц/отчётов.
• Автосвязка UI↔PDF: CSS-темы могут автоматически связываться с PDF-шаблоном (переключатель + Разъединить).
• Общая библиотека: сохранение общих типографских пресетов.
• Полный справочник функций шаблонов: docs/template-functions-overview-en.md.

13. Метаданные и front matter

• Редактор метаданных: название, автор, ISBN.
• YAML front matter для согласованного экспорта.
• EPUB: обложка и метаданные настоятельно рекомендуются.

14. Проекты и режим структуры

1. Документы → Управление проектом.
2. Создайте папку проекта.
3. Добавьте главы (.md).
4. Переупорядочивайте перетаскиванием.
5. Экспортируйте всё с автоматическим порядком.

15. Экспорт подробно

15.1 Базовый PDF (Typst)

• Быстрый, без LaTeX.
• Идеален для черновиков и вычиток.

15.2 PDF/X (LaTeX)

• Использует сертифицированный шаблон.
• Требует LaTeX + Ghostscript.
• Поддерживает ICC, валидацию и preflight.

15.3 PDF-сценарий

• Голливудская вёрстка.
• Совместим с Fountain.

15.4 FDX (Final Draft)

• Экспорт для кинопроизводственных процессов, с отчётом .breakdown.json рядом (сцены, персонажи, теги).
• Одновременный диалог: добавьте ^ после имени второго персонажа (GUIDO^) — в Final Draft реплики отображаются в две колонки (нативный dual dialogue); при импорте .fdx ^ возвращается автоматически.
• Производственные теги: правый клик по выделенному слову → Тег для производства, или напишите [[prop: фонарь]] или #prop: фонарь в конце строки. В FDX они становятся нативными тегами Tagger; в других форматах маркеры удаляются; теги, поставленные в Final Draft, возвращаются при импорте.
• Основные ключи (итальянский или английский): prop, costume, vehicle, sound, music, makeup, animal, effects, location, note.
• Название и автор (front matter или # Название + «by …» в начале документа) попадают на Title Page Final Draft.

15.5 DOCX/ODT

• Конвертация через Pandoc.

15.6 EPUB

• Метаданные + обложка рекомендуются.
• Совместим с цифровыми магазинами.

15.7 HTML

• Веб-вывод с ресурсами.

15.8 ICML

• Стили, сопоставленные для InDesign/InCopy.
• Заголовки, списки, цитаты и сценарий преобразуются в отдельные стили.
• Включённые пресеты шаблонов + импорт собственного .icml.
• Настоящие сноски (нумерует InDesign), ссылки с назначениями, таблицы с шапками и выравниванием, изображения как связанные фреймы (панель «Связи»), над-/подстрочные и капитель — в том числе внутри ячеек, сносок и ссылок.
• Точный реимпорт: экспортированный и снова открытый в PressWork ICML сохраняет документ (круговой цикл проверен в CI, включая длинные рукописи).

15.9 Excel

• Экспорт Excel с разбором сцен, персонажей и производства.
• Поддержка шаблонов: запись в существующие листы для сохранения базовых стилей.
• Импорт нескольких листов в таблицы Markdown (с метаданными типа/ячейки).
• Выбор листа и диапазона при импорте, чтобы избежать лишних данных.
• Chart Mapper: опционально, строит превью-графики из данных Excel.

16. Расширенный экспорт

• Мультиэкспорт: объединяет несколько документов.
• Мультиформатный экспорт: создаёт PDF+EPUB+HTML в одной папке.
• Экспорт с ресурсами: копирует изображения и ресурсы.
• История экспорта: журнал и результаты.

17. KDP (Amazon)

• Quick Export: PDF + EPUB с именованием KDP.
• Калькулятор: размеры и поля.
• Шаблоны KDP: специальные обложки/вёрстка.
• Валидатор ePub: чек-лист, предпросмотр Kindle и скачиваемый отчёт.

18. Анализ стиля

• Длинные фразы, повторы, пассивный залог.
• Встроенные подсказки.
• Метрики читаемости.

19. ИИ-ассистент

• Резюме, переписывание, согласованность, заголовки.
• Облачные сервисы уже готовы в меню: OpenAI, Anthropic (Claude), Mistral и агрегаторы вроде OpenRouter. Выбор сервиса задаёт адрес и модель — остаётся только вставить ключ.
• Каждый сервис помнит свой ключ: при переключении его больше не нужно вводить заново. Ключи хранятся в связке ключей операционной системы, а не в файле приложения.
• Локальные модели: «Найти Ollama» покажет установленные на вашем компьютере. Там ключ не нужен, и ничего не покидает машину.
• Проверка соединения проверяет тот канал, которым вы действительно пользуетесь — облачный, если есть ключ, иначе локальный — и сообщает, какой именно проверил.

20. Совместная работа (P2P)

• Общие сессии с цветными удалёнными курсорами, встроенными комментариями и живой синхронизацией.
• Встроенные голосовые/видеозвонки во время сессии.
• Общий ID сессии (pw-...) для быстрого приглашения других пользователей.

Как пользоваться (по шагам)

1. Откройте Инструменты → Collab и выберите узнаваемое имя.
2. Создайте новую сессию или вставьте ID, полученный от коллеги.
3. Дождитесь статуса Online и проверьте участников в доке совместной работы.
4. Для голоса/видео начните звонок с панели Collab и используйте кнопки «микрофон»/«камера».
5. В ограниченных корпоративных сетях настройте WebSocket-релей (ключ localStorage: presswork-collab-relay-url).

21. Цифровая подпись

• Подпись PDF сертификатом PAdES-T.
• Метка времени RFC 3161 (нужна сеть).

22. Презентация

• Превращает документы в слайды.
• Настраиваемые макеты и палитры.

23. Доступность

• Размер текста 12–18px.
• Высокий контраст.
• Шрифт для дислексии.

24. Основные горячие клавиши

• Ctrl/Cmd + S → Сохранить
• Ctrl/Cmd + N → Новый
• Ctrl/Cmd + P → Command Palette
• Ctrl/Cmd + Shift + P → Презентация
• F11 → Режим фокуса
• Ctrl/Cmd + B/I/U → Жирный/Курсив/Подчёркнутый
• Ctrl + Alt + V → Vim

25. Решение проблем

• PDF/X недоступен: установите LaTeX + Ghostscript и перезапустите.
• Шаблоны не видны: используйте «Открыть папку шаблонов» и проверьте расширения.
• Медленный экспорт: отключите валидацию на этапе черновика.

26. Полезные пути

• Пользовательские шаблоны: папка presswork/templates в каталоге конфигурации пользователя.
• PDF/X ICC: папка presswork/pdfx.

Presswork объединяет простоту и профессиональные редакционные инструменты: пишите быстро в Base, публикуйте в Pro.

Недавние обновления (Data Hub / Графики)

• Вставка графика из Excel Data Hub теперь сразу показывает превью-изображение и в редакторе, а не только в панели предпросмотра.
• Встроенное превью уменьшено (примерно на 50 %), чтобы меньше мешать при письме.
• Двусторонний переключатель: 📝 Показать код открывает блок chart-data, 🖼️ Вернуться к графику восстанавливает вид изображения.
• Блок chart-data остаётся в Markdown для совместимости с предпросмотром/рендером/экспортом.
• Вставка таблицы или графика как изображения теперь сохраняет файл в ресурсы документа (имядок.assets/images/), а в редактор попадает только Markdown-ссылка: работает даже с очень большими листами.
• Если документ ещё не сохранён, приложение предлагает сохранить его сразу (как при перетаскивании изображений); при отказе таблица вставляется текстом Markdown, а график остаётся в листе.
• Вопрос «текст/изображение» понимает и ответы вроде «png», «jpg», «изображение», «фото»; нераспознанный ответ повторяет вопрос.
• Сетка данных следует активной светлой/тёмной теме.
• Сохранить как шаблон: окно переработано в стиле приложения и переведено. Требует данных в сетке и модели в редакторе с плейсхолдерами {{ИмяКолонки}}; «Сгенерировать Markdown» повторяет модель для каждой строки.
• Экспорт Excel (разбор): читает текст редактора (сцены INT./EXT. или главы #); если сцен нет, теперь предупреждает вместо создания пустого файла.
• Упрощено меню Tables: удалён дублирующий пункт «Импортировать как шаблон» (идентичен «Открыть лист Tables»).
• Панель Импорт/Экспорт: новая вкладка Пакетные (рядом с Базовый формат / Про-печать / Сценарий / Издательство) с пакетными действиями: Конвертировать папку, Мультиэкспорт, Мультиформат, С ресурсами. Расширенные опции показывают только то, что относится к выбранному формату.
• 🧪 Проверить ICML: в панели экспорта (формат ICML) проверяет созданный документ — иерархию, front matter, экранирование, пустые абзацы — ничего не записывая на диск; детали появляются в окне внутри приложения. Та же проверка в любом случае выполняется при каждом экспорте ICML.
• Более безопасный экспорт FDX: обычный Markdown (списки, таблицы, заметки) всегда становится Action — никогда случайно Персонажем/Диалогом; настоящие сценарии по-прежнему интерпретируются (сцены, персонажи, реплики, переходы). \newpage становится настоящим разрывом страницы (и в ICML — через переназначаемый стиль «Разрыв страницы»).
• Печать через PDF: кнопка «Печать» создаёт временный PDF (Typst, та же типографика, что и в экспорте) и открывает его в системном просмотрщике — печать через нативный диалог с точным предпросмотром.
• Настройки переупорядочены: раздел Установки (LaTeX в один клик, статус Ghostscript), язык в компактном виде, тема с чипами Тёмная/Светлая. Быстрые промпты панели ИИ сворачиваются.

27. Углублённый разбор функций (закрытые пробелы)

Этот раздел дополняет продвинутые функции, которые часто не используются из-за слабой видимости в меню.

27.1 ИИ: конфигурация, диагностика и качество ответа

• Настраиваемые облачные/локальные endpoint'ы (совместимые с OpenAI, Ollama, LM Studio) через переменные PRESSWORK_AI_ENDPOINT, PRESSWORK_AI_MODEL, PRESSWORK_AI_API_KEY.
• Диагностика ИИ-подключения с экспортируемым JSON-отчётом (полезно для техподдержки/ИТ-команд).
• Управление стилем ответа (краткий/сбалансированный/подробный), предпросмотр технического промпта и повтор последнего промпта.
• Закрепление endpoint/модели на проект: сохраняет редакционную согласованность между документами.

27.2 Статистика: метод расчёта (практика)

• Средняя продуктивность: по дневной истории (7 дней / 30 дней).
• Скорость письма: все слова, делённые на окно сессий (слова/час и слова/мин).
• TTR (Type-Token Ratio): уникальные слова / все слова.
• MSTTR: средний TTR по окнам из 50 слов (снижает искажение на длинных текстах).
• Flow state в реальном времени: средний интервал нажатий + доля недавних удалений.
• Прогноз завершения: оптимистичная/пессимистичная оценка по средним 7д и 30д.

27.3 Продвинутый экспорт, отсутствующий в кратком руководстве

• Final Draft (.fdx): сопоставляет заголовки настоящим Scene Heading, поддерживает заметки/разрывы страниц/нумерацию сцен и создаёт сопутствующий файл .breakdown.json.
• ICML: продвинутое типографское сопоставление (заголовки/списки/цитаты/сценарий) + пресеты + импорт собственного .icml.
• Мастер EPUB/ICML: блокирует экспорт, пока не заданы минимальные метаданные (название/автор/ISBN) и обложка.
• Подпись PDF: PKCS#7 detached + метка времени RFC 3161.

27.4 Режим Bundle (.pwk)

• Основное действие: Экспорт с выбором назначения.
• Автоматические цели вывода для уменьшения ручных ошибок пути.
• Переключатель в шапке для временного показа классического быстрого экспорта.

27.5 Совместная работа (P2P) в реальных условиях

• Общий ID сессии pw-..., цветные удалённые курсоры, встроенные комментарии, живая синхронизация.
• Голосовой/видеозвонок в той же редакционной сессии.
• Резервный WebSocket-релей, если WebRTC не проходит (корпоративные сети/файрволы), через ключ presswork-collab-relay-url.

27.6 Система шаблонов (профессиональное использование)

• Импорт файла/папки с автоматической классификацией (Business / Документы / UI Kit).
• Поддержка бинарных и табличных шаблонов для потоков отчётности.
• Автосвязка UI↔PDF для соединения темы редактора и стиля экспорта, с опцией «Разъединить».

27.7 Рекомендуемый рабочий чек-лист

1. Установите режим Base/Pro в зависимости от результата работы.
2. Проверьте требования в Проверке экспорта (LaTeX/Ghostscript — только если нужен PDF/X).
3. Выполните Preflight перед сдачей.
4. Для EPUB/ICML завершите мастер метаданных + обложки.
5. Для подписанных документов включите подпись PKCS#7 + метку времени.
6. В команде зафиксируйте ID сессии Collab и резервный релей во внутреннем регламенте.

28. Подключить помощника (MCP)

Начиная с 4.2 PressWork служит мостом MCP: чат-помощники (Claude Desktop, Codex CLI, Gemini CLI…) читают ваши проекты .pwk прямо на вашем компьютере — главы, заметки, статистику — без копипаста. Только чтение: у моста нет ни одного инструмента записи, только семь для чтения. Если у подключённого помощника есть собственные инструменты доступа к файлам компьютера, они работают не через PressWork.

• Настройка в один клик: Настройки → ИИ → Подключить помощника (MCP) → «Настрой за меня» (Claude Desktop / Codex CLI / Gemini CLI). Подключается папка открытого проекта со всеми .pwk внутри.
• Полностью закройте помощника перед настройкой (Claude Desktop переписывает свою конфигурацию при закрытии), затем откройте снова. Перед записью приложение делает резервную копию конфигурации.
• Папки суммируются: настройте из проектов в разных папках — помощник увидит все. Работает и при закрытом PressWork.
• В Claude: обычные чаты живут в облаке и не достают до вашего компьютера — выберите активность «На вашем компьютере» или отметьте коннектор presswork.
• Другие MCP-клиенты (Cursor, OpenCode…): ручной сниппет конфигурации для копирования. Через Экспорт Компетенции вы создаёте skill, который учит Claude наилучшим образом работать с вашими проектами (добавляется один раз, действует навсегда).
• Приватность, честно: то, что помощник читает, отправляется в его облачный сервис для обработки ответа — как копипаст, только автоматический. Не подключайте проекты, которые не отправили бы в чат.
• Требуется рабочий вид Complete.

29. Ветви и варианты главы

Два разных инструмента для одного вопроса — «а если наоборот…» — на двух разных масштабах.

Ветвь — это другая книга. А в каждой книге у каждой главы могут быть свои варианты.

29.1 Ветви

• Ветвь — альтернативная версия всего документа: другой финал, убранный персонаж, иная структура. Основной документ остаётся нетронутым.
• Панель: Ctrl/Cmd+Shift+B или через меню. Открыть ветвь — значит войти в неё: с этого момента вы пишете там.
• Где вы находитесь, видно всегда: внизу окна появляется плашка с именем ветви. Нет плашки — вы в основном документе, том, что идёт в печать.
• Повысить делает ветвь настоящим документом (прежний основной архивируется как ветвь). Diff сравнивает строка за строкой. Экспортировать отделяет ветвь в самостоятельный .pwk.
• Все ветви лежат в одном .pwk: никаких лишних файлов, никакого Git.
• Карточки Синопсиса показывают, где дороги расходятся: на каждой карточке главы появляется отметка цветом ветки там, где эта глава отличается, и перечёркнутая там, где её нет. Клик открывает Ветки. Карточки, одинаковые во всех ветках, остаются чистыми: молчание означает «здесь ничего не разошлось». Находясь внутри ветки, сравнение включает и основной документ — именно с ним и нужно сверяться, пока пробуешь другой путь.
• Главы, которые живут только в другом месте, не пропадают из виду: внизу Синопсиса при необходимости появляется список глав, существующих только в другой версии. Это особенно важно для переименованных, ведь главы распознаются по заголовку.

29.2 Варианты главы

• Вариант — вторая редакция одной главы: на бумаге это было «зачеркнуть кусок и написать рядом другой». В тексте живым остаётся только один — он и попадает в файлы.
• Создать: Синопсис → наведите курсор на карточку главы → ⑂ справа вверху. Текущий текст становится первой редакцией; новой вы даёте имя.
• Переключить: нажмите значок ⑂ на карточке и выберите. Активный помечен «в тексте». Меняется только эта глава.
• Удалить: корзина в меню. Активный удалить нельзя: сначала перейдите на другой.
• Где это видно: строка состояния, рядом со счётчиком слов — ⑂ вариант: имя. Если у главы под курсором вариантов нет, об этом тоже сказано, серым.
• У каждой ветви свои варианты: созданные внутри ветви не показываются в основном документе, и это сделано намеренно.

29.3 Если что-то не сходится

• Переименовал главу — варианты пропали: они не потеряны. Внизу Синопсиса есть полоса «Варианты без главы» со всем, что сейчас не нашло места; через меню «назначить…» вы возвращаете их на нужную главу. PressWork пытается сам отследить переименование, но, не будучи уверенным, предпочитает показать материал, а не угадывать.
• Отмена работает и здесь: смена варианта — такая же правка текста, как любая другая (Ctrl/Cmd+Z).
• На диске: versions/branches/<id>/ и versions/variants/ внутри .pwk. Это обычные .md: даже без PressWork работа читается.