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

Это руководство описывает все функции Presswork.

1. Обзор

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

2. Требования

• Встроено: Pandoc, Typst.
• Опционально (Pro): LaTeX + Ghostscript.

Проверка:

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

3. Режимы (Base / Pro)

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

4. Интерфейс

Верхнее меню, Markdown‑редактор, боковые панели, строка статуса.

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

Новый, Сохранить, Импорт, Проекты, Структура, Печать, Версии.

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

Цели, Статистика, Руководство, Проверка экспорта, Палитра команд, Анализ стиля, AI, Vim, Collab, Тур, Цифровая подпись.

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

Форматы: PDF, PDF/X, сценарий PDF, FDX, DOCX/ODT, EPUB, HTML, ICML. Опции: стиль PDF, ICC, валидация, preflight, история, multi‑export, multi‑format, assets, batch.

8. Меню Вид

Режимы, язык, тема, машинка, фокус, презентация, доступность.

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

Форматирование, заголовки, ссылки, изображения, код, списки, таблицы, CriticMarkup, шаблоны, метаданные, снимки, синопсис.

10. Боковые панели

Outline, Snapshots, Backlinks, Scrivener, Scene Navigator.

11. Markdown

Базовый синтаксис + \newpage. Drag & drop изображений.

12. Шаблоны

Встроенные + пользовательские.

• .md загружаются в редактор.
• .tex выбираются как стиль PDF.
• Общая библиотека.

13. Метаданные

YAML front‑matter, EPUB метаданные и обложка.

14. Проекты

Главы, порядок, общий экспорт.

15. Детали экспорта

PDF (Typst), PDF/X (LaTeX), PDF сценарий, FDX, DOCX/ODT, EPUB, HTML, ICML (маппинг стилей, пресеты + импорт .icml). Есть Excel‑экспорт с breakdown, шаблонами, multi‑sheet импортом (выбор листа) и предпросмотром графиков.

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

Multi‑export, multi‑format, export with assets, история.

17. KDP

Быстрый экспорт, калькулятор, шаблоны KDP и валидатор ePub с чек‑листом, предпросмотром Kindle и скачиваемым отчетом.

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

Повторы, читабельность, подсказки.

19. AI‑ассистент

Сводки, переписывание, проверка согласованности.

20. Коллаборация

Совместные сессии, live‑sync.

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

Подпись PDF (PAdES‑T).

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

Документы как слайды.

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

Размер текста, контраст, шрифт для дислексии.

24. Горячие клавиши

Ctrl/Cmd+S, Ctrl/Cmd+N, Ctrl/Cmd+P, F11, Ctrl/Cmd+B/I/U, Ctrl+Alt+V.

25. Troubleshooting

PDF/X недоступен, шаблоны не видны, медленный экспорт.

26. Пути

Шаблоны: presswork/templates, PDF/X ICC: presswork/pdfx.

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

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

27. Глубокий разбор функций (добавлено)

Этот раздел закрывает функции, которые уже были в приложении, но слабо описаны в краткой версии руководства.

27.1 AI: настройка и диагностика

• Облачные/локальные AI‑endpoint’ы (OpenAI-compatible, Ollama, LM Studio) через PRESSWORK_AI_ENDPOINT, PRESSWORK_AI_MODEL, PRESSWORK_AI_API_KEY.
• Диагностика подключения с экспортируемым JSON‑отчётом.
• Управление стилем ответа (кратко/сбалансированно/подробно), предпросмотр техпромпта, повтор последнего запроса.
• Фиксация endpoint/модели на уровне проекта для редакционной согласованности.

27.2 Методика расчёта статистики

• Средняя продуктивность: окна 7/30 дней.
• Скорость письма: по дельтам слов в диапазоне сессий (слов/час, слов/мин).
• TTR = уникальные слова / общее число слов; MSTTR = средний TTR по окнам 50 слов.
• Realtime flow: средний интервал нажатий + доля удалений за последнее время.
• Прогноз завершения: оптимистичный/пессимистичный диапазон на базе 7d vs 30d.

27.3 Продвинутые экспорты (теперь описаны полностью)

• Final Draft (.fdx): заголовки глав → Scene Headings, опции notes/page breaks/scene numbering, sidecar .breakdown.json.
• ICML: расширенный маппинг стилей (заголовки/списки/цитаты/сценарий) + пресеты + импорт своего .icml.
• Wizard EPUB/ICML блокирует экспорт, пока не заполнены обязательные метаданные и обложка.
• Подпись PDF: PKCS#7 detached + RFC 3161 timestamp.

27.4 Bundle‑режим (.pwk)

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

27.5 Коллаборация в ограниченных сетях

• Общий ID сессии pw-..., цветные удалённые курсоры, inline‑комментарии, live sync.
• Встроенные голос/видео звонки.
• Fallback на WebSocket relay при проблемах WebRTC (presswork-collab-relay-url).