
Vivliostyle CLI необходим тем, кто собирает PDF как воспроизводимый проект из Markdown, HTML и CSS, а не правит готовые страницы ручным способом. На Xeon Live можно скачать Vivliostyle CLI бесплатно и свериться с базовым описанием программы; ниже разберём рабочий процесс от первой команды до многофайловой публикации, предпросмотра и автоматической сборки.
Что представляет собой Vivliostyle CLI и для каких задач он необходим
Vivliostyle CLI — командный инструмент для книжной и документной верстки на базе веб-технологий. Исходником служит Markdown, HTML, публикационный манифест или EPUB, а оформление задаётся CSS и параметрами проекта. Важное отличие от обычного PDF-редактора в том, что итог всякий раз строится заново из мастер-файлов. Такой подход в особенности удобен для технической документации, методичек, отчётов, электронных книг и систематически обновляемых материалов, где текст живёт в Git, а выпуск должен повторяться без ручной переклейки страниц.
Где программа сильна и где её возможности заканчиваются

Сильная сторона Vivliostyle CLI — управление структурой и типографикой через текстовые файлы. Можно хранить главы отдельно, менять тему без переписывания рукописи, задавать формат листа, поля, колонтитулы, счётчики, оглавление и обложку, а затем выпускать один и тот же материал в PDF, EPUB или WebPub там, где это допускает тип входа. Это близко к сборке сайта или приложения: важен не отдельный экспортированный файл, а вся цепочка исходников, зависимостей и конфигурации.
Vivliostyle CLI не предназначен для OCR, ручного редактирования чужого PDF, удаления объектов на отдельной странице, заполнения форм или косметической правки скана. Для таких задач необходим редактор готовых PDF. Если же источник существует в HTML или Markdown и документ меняется систематически, пересборка даёт больше контроля: правка одной строки остаётся в исходнике, а все страницы, оглавление и ссылки пересчитываются автоматически. Для общего понимания формата полезно держать под рукой разбор формата PDF на Xeon Live.
- Подходит для книг, руководств и регламентов, где текст разбит на главы и систематически обновляется.
- Удобен для документации из репозитория, когда изменения надо видеть как текстовый diff, а выпуск повторять командой.
- Полезен для отчётов, которые формируются из HTML-шаблона и данных, а затем одинаково собираются локально и в CI.
- Не заменяет визуальную программу допечатной подготовки, когда требуется ручным способом двигать отдельные объекты мышью.
- Не заменяет PDF-редактор для исправления чужого готового файла без исходников.
Рабочая среда: терминал, структура проекта и Vivliostyle Viewer
У Vivliostyle CLI нет отдельного настольного окна с холстом. Рабочая среда складывается из терминала, редактора кода, файлов проекта и браузерного Vivliostyle Viewer. Такая схема сперва кажется непривычной тем, кто пришёл из DTP-программ, но быстро становится логичной: рукопись отвечает за содержание, CSS — за вид, конфигурация — за порядок и выпуск, Viewer — за визуальную проверку пагинации.
Терминал и файлы проекта

В терминале выполняются команды создания проекта, предпросмотра и сборки. В корне обычно лежат package.json, файл блокировки зависимостей и vivliostyle.config.js; главы удобно хранить в src или manuscripts, изображения — в assets, CSS — в styles. Такой порядок не навязан программой, но снижает количество ошибок с относительными путями. При запуске из другого каталога один и тот же путь к картинке или шрифту может разрешаться иначе, по этой причине рабочую папку лучше считать частью процедуры выпуска.
Для совместной работы полезно ставить Vivliostyle CLI в сам проект, а не только глобально. Тогда версия фиксируется зависимостями, а запуск идёт через npx или npm scripts. Это уменьшает риск, что у автора и на сервере установлены различные выпуски CLI. Отдельный workspaceDir удобно выделить под промежуточные HTML: тогда сгенерированные файлы не смешиваются с рукописью и легко удаляются перед чистой сборкой.
Vivliostyle Viewer как основной экран проверки

Команда preview запускает локальный сервер и открывает Viewer в браузере. Тут видно то, чего не показывает редактор исходника: реальные границы страниц, пустые листы, положение иллюстраций, колонтитулы, развороты и итог переноса текста. Панель Viewer позволяет переходить между страницами, менять масштаб и режим просмотра. Для длинного документа логично проверять не всё подряд, а заблаговременно выбранные контрольные места: начало каждой главы, страницу с широкой таблицей, крупную иллюстрацию, сноски, последний разворот и оглавление.
В режиме --quick публикация с большим числом входов открывается быстрее, потому что количество страниц оценивается примерно. Этот режим годится для быстрой правки конкретной главы, но не для контроля окончательных номеров страниц и целевых ссылок. Перед выпуском необходим обычный preview без ускорения, а затем полноценный build в том же окружении и с теми же стилями.
Первый PDF из Markdown или HTML: пошаговый рабочий сценарий
Начинать лучше с минимального файла и лишь после успешной сборки добавлять тему, свои шрифты, оглавление и сложную конфигурацию. Так проще отделить проблему среды от ошибки в CSS или структуре публикации. Текущая документация Vivliostyle CLI требует Node.js 22.12.0 или новее; перед установкой проверьте версию Node, потом поставьте пакет и убедитесь, что команда отвечает на help.

Сборка Markdown/VFM в PDF

- Шаг 1. Создайте отдельную папку проекта и откройте её в терминале. Выполните npm init -y, затем установите зависимость командой npm install @vivliostyle/cli. Проектная установка предпочтительна для повторяемой сборки, потому что версия фиксируется в package.json и lock-файле.
- Шаг 2. Создайте manuscript.md и добавьте короткий документ с заголовком первого уровня, несколькими абзацами, списком и одной ссылкой. Сперва не подключайте сложный CSS: задача этого шага — проверить преобразование VFM и работу движка.
- Шаг 3. Запустите npx vivliostyle preview manuscript.md. В браузере должен открыться Viewer с разбитым на страницы текстом. Проверьте, что заголовок не обрезан, список отображается целиком, а переход между страницами работает.
- Шаг 4. Соберите файл командой npx vivliostyle build manuscript.md -o book.pdf. Для A4 добавьте -s A4. После окончания откройте book.pdf обычным просмотрщиком и сопоставьте первую, среднюю и последнюю страницу с Viewer.
- Шаг 5. Добавьте изображение относительным путём и повторите preview. Если картинка пропала, проверьте регистр имени файла и фактическое расположение ресурса относительно рукописи. На Linux различие Cover.png и cover.png существенно.
- Шаг 6. Лишь после стабильной базовой сборки вынесите стили в отдельный CSS и подключите его через --style styles/print.css или конфигурацию. Это позволит сразу понять, относится ли новый дефект к содержанию или к оформлению.
VFM сохраняет привычную логику Markdown, но ориентирован на публикации. В нём доступны конструкции для сносок, подписей, фрагментов HTML и другой семантики, которая затем превращается в HTML и участвует в пагинации. При сложном оформлении полезно посмотреть фактический HTML, который получился из конкретной конструкции, и уже по нему строить CSS-селекторы. Это надёжнее, чем подбирать селектор по догадке.
Сборка готового HTML в PDF
Для HTML процедура ещё короче. Подготовьте index.html с корректной структурой head/body и подключённым CSS. Выполните npx vivliostyle preview index.html, а после проверки — npx vivliostyle build index.html -o output.pdf. Если в HTML применяются локальные изображения, шрифты и таблицы стилей, убедитесь, что они доступны из рабочей папки. Для веб-страницы с внешними ресурсами лучше сперва сделать статическую копию, чтобы выпуск не зависел от авторизации, динамических данных или изменяющихся сетевых файлов.
Отдельный практический сценарий — преобразование уже существующей HTML-страницы. Vivliostyle CLI умеет принимать и веб-адрес, однако для воспроизводимого выпуска предпочтительнее локальный набор HTML/CSS/assets. Тогда редакция контролирует исходник, шрифты и изображения, а повторная сборка через месяц не зависит от чужого сервера. На Xeon Live есть отдельная инструкция по преобразованию HTML в PDF, где рассмотрены и другие методы для различных платформ.
Многофайловая публикация: config, порядок глав и несколько выходов
Одиночная команда удобна для статьи, но книга или руководство быстро перерастают один файл. Тогда центр проекта — vivliostyle.config.js. Его можно создать через init или получить вместе с новым проектом, созданным через npm create book@latest. Конфигурация фиксирует метаданные, последовательность entry, тему, размер, оглавление, обложку, рабочую папку и output.
Как собрать книгу из нескольких глав

- Шаг 1. Разделите рукопись на логические файлы, к примеру 01-intro.md, 02-workflow.md и 03-reference.md. Имена с числовыми префиксами удобны для навигации, но итоговый порядок всё равно должен задаваться явно в entry.
- Шаг 2. Создайте vivliostyle.config.js и задайте title, author и language. Для русскоязычного материала укажите языковой код ru, чтобы HTML получал корректный lang и типографические механизмы имели верный контекст.
- Шаг 3. В entry перечислите главы в точном порядке чтения. Для отдельной главы можно применять объект с path, title и собственной theme. Не полагайтесь на алфавитный порядок каталога: явный массив легче проверить при рецензировании.
- Шаг 4. Добавьте workspaceDir, к примеру .vivliostyle, чтобы промежуточные HTML не лежали рядом с рукописью. После этого запустите npx vivliostyle preview без имени файла — CLI возьмёт конфигурацию проекта.
- Шаг 5. Пройдите публикацию по структуре: титул, оглавление, главы, приложения. Убедитесь, что первая страница каждой главы соответствует задуманному порядку и что относительные изображения открываются после преобразования Markdown.
- Шаг 6. Соберите npx vivliostyle build и проверьте имя выходного файла. Для командной работы зафиксируйте package-lock.json, pnpm-lock.yaml или yarn.lock вместе с конфигурацией.
Несколько выходных форматов из одного проекта

Поле output принимает строку, объект или массив. Это позволяет описать, к примеру, PDF и WebPub в одной конфигурации. Для EPUB и WebPub необходим подходящий вход: Markdown, HTML, webbook или publication manifest; если исходником служит готовый EPUB/OPF, поддерживается преобразование в PDF, но не повторная упаковка в новый EPUB. По этой причине форматную стратегию лучше выбрать до начала верстки, а не в самом конце.
- Шаг 1. Оставьте общую семантику в HTML/VFM и избегайте оформления, которое существует только ради фиксированного листа.
- Шаг 2. Для PDF задайте page size, поля, колонтитулы и при необходимости печатные метки. Для электронных форматов не переносите эти правила механически.
- Шаг 3. В output добавьте отдельные объекты с path и format. После сборки откройте каждый итог своим типичным просмотрщиком, а не оценивайте EPUB только по PDF.
- Шаг 4. Проверьте порядок чтения, альтернативные тексты изображений, заголовки и навигацию в электронном выпуске. Фиксированная страница может скрыть структурную проблему, которая сразу проявится в ридере.
- Шаг 5. Храните выходы вне каталога исходников. Перед повторным выпуском очищайте старые артефакты, чтобы не принять файл от предыдущей успешной сборки за новый.
CSS для печатной страницы: темы, поля, колонтитулы и разрывы
В Vivliostyle CLI оформление строится теми же принципами, что и веб-страница, но поверх обычного CSS добавляется модель paged media. Тема задаёт базовую типографику, авторский CSS уточняет конкретное издание, а @page управляет размером листа и областями страницы. Такой слой лучше развивать постепенно: сперва типографика потока, затем формат листа, затем колонтитулы и лишь после этого сложные разрывы.
Тема и добавочный CSS

Готовую Vivliostyle Theme можно подключить параметром -T/--theme или полем theme в конфигурации. Добавочный авторский файл подключается через --style, а пользовательский — через --user-style. Для постоянной верстки практичнее хранить все изменения в файлах, а не передавать длинный CSS прямо в командной строке: так изменения рецензируются, сопоставляются и одинаково применяются в CI.
- Шаг 1. Подключите одну тему и выполните preview без собственных переопределений. Зафиксируйте, как выглядят заголовки, абзацы, списки, таблицы и код.
- Шаг 2. Создайте styles/print.css и подключите через --style. Начните с базовых параметров body, заголовков и изображений; после каждого небольшого блока правил обновляйте Viewer.
- Шаг 3. Если правило не сработало, откройте сгенерированный HTML и проверьте реальную структуру элемента. Потом сопоставьте специфичность и порядок каскада. Массовое добавление !important обычно скрывает причину конфликта.
- Шаг 4. Шрифты подключайте через @font-face из контролируемого каталога. После замены гарнитуры обязательно пересмотрите пагинацию: другой шрифт меняет длину строк, высоту абзацев и номера страниц.
- Шаг 5. Проверяйте крайние случаи отдельно: длинную строку кода, широкую таблицу, крупную иллюстрацию, длинную сноску и заголовок, который едва помещается в одну строку.
Размер листа, поля и печатные метки
Размер можно задать параметром -s/--size: документация перечисляет A5, A4, A3, B5, B4, JIS-B5, JIS-B4, letter, legal и ledger, а также произвольную пару размеров. Для стабильного проекта формат лучше вынести в CSS через @page или конфигурацию. Поля страницы задаются в @page, а не margin у body: это различные уровни модели.
- Шаг 1. Для черновика задайте -s A4 и убедитесь, что весь контент помещается без горизонтального переполнения.
- Шаг 2. Перенесите размер и поля в @page. Для зеркального книжного разворота применяйте :left и :right, чтобы внутреннее и внешнее поле менялись местами.
- Шаг 3. Если необходим печатный выпуск, включите -m/--crop-marks. При надобности добавьте --bleed и --crop-offset в соответствии с требованиями типографии.
- Шаг 4. Проверьте, что фоновые изображения в самом деле доходят до зоны вылета, а важный текст не приближается к линии реза. Само наличие меток не исправляет геометрию макета.
- Шаг 5. Откройте итоговый PDF средством, которое показывает размеры и боксы страницы. Сопоставьте trim size с заданным форматом и лишь после этого передавайте файл дальше.
Колонтитулы, счётчики и управляемые разрывы

Номер страницы обычно выводится в margin box через counter(page). Для бегущего заголовка значение главы можно захватить string-set и вывести функцией string(). Сложность появляется не в синтаксисе, а в правилах исключений: обложка, титул и начало главы часто не должны показывать те же элементы, что обычная текстовая страница.
- Шаг 1. Добавьте номер страницы в @bottom-center и проверьте пять последовательных страниц, включая начало новой главы.
- Шаг 2. Настройте отдельное правило для первой страницы главы, чтобы не дублировать крупный заголовок в колонтитуле.
- Шаг 3. Для наименования текущей главы примените string-set к заголовку и выведите строку в верхней области страницы. Перелистайте границу между двумя главами и проверьте момент смены значения.
- Шаг 4. Применяйте break-before и break-after только там, где разрыв в самом деле семантически необходим. break-inside: avoid оставляйте для сравнительно небольших связанных блоков, иначе большой элемент способен создать огромную пустую зону.
- Шаг 5. После любой правки шрифта, межстрочного интервала или размеров изображения вновь проверьте оглавление и целевые номера: они зависят от полной пагинации.
Предпросмотр, оглавление, обложка и итоговый экспорт
После того как содержание и CSS собраны, рабочий цикл становится повторяющимся: изменить исходник, открыть preview, проверить критические страницы, выполнить build, проверить готовый файл. На данном этапе важны не новые эффекты, а дисциплина контроля. Viewer должен применять те же входы и стили, что финальная сборка.
Как проверять публикацию в Viewer

Проверка от общего к частному быстрее случайного листания. Сперва убедитесь, что порядок служебных страниц и глав правильный. Потом проверьте геометрию разворота, после — крупные объекты и лишь в конце мелкую типографику. При больших проектах составьте короткий набор контрольных страниц и возвращайтесь к нему после каждой заметной правки CSS.
- Шаг 1. Запустите npx vivliostyle preview из корня проекта и дождитесь полной пагинации.
- Шаг 2. Перейдите к титулу, оглавлению, первой странице каждой главы и последней странице. Проверьте, что пустые листы появляются только там, где они задуманы правилами разворота.
- Шаг 3. Откройте страницу с самой широкой таблицей и страницу с самым большим изображением. Ищите выход за поле, обрезанные подписи и пустоты, вызванные запретами разрыва.
- Шаг 4. Проверьте сноски, внутренние ссылки и несколько внешних ссылок. Для навигации между главами в особенности важны устойчивые id после преобразования Markdown.
- Шаг 5. Для быстрой локальной правки разрешён --quick, но перед финальным build вновь откройте обычный режим. Сопоставлять номера страниц из quick с окончательным PDF бессмысленно.
- Шаг 6. После сборки откройте PDF отдельно от Viewer и проверьте выбор текста, переходы по оглавлению и свойства документа. Viewer подтверждает верстку, но не заменяет проверку финального контейнера.
Оглавление и навигация без ручной нумерации
Поле toc: true создаёт HTML-страницу оглавления. Объект toc позволяет менять имя файла, заголовок и sectionDepth от 1 до 6. Если оглавление должно стоять не первым, в entry применяется служебный элемент с rel: contents. Для собственного шаблона готовят HTML с nav role="doc-toc", куда CLI вставляет пункты. Печатные номера должны зависеть от полной пагинации, а не быть набраны ручным способом в Markdown.



- Шаг 1. Включите toc: true и соберите короткую книгу из трёх глав. Проверьте, что каждая глава появилась в оглавлении ровно один раз.
- Шаг 2. Увеличьте sectionDepth на один уровень и оцените, не стало ли оглавление перегруженным. Включать все H1–H6 обычно не нужно.
- Шаг 3. Если оглавление должно идти после титула, поставьте { rel: contents } в нужную позицию entry и вновь проверьте последовательность страниц.
- Шаг 4. Измените объём первой главы на несколько абзацев и выполните полную пересборку. Номера следующих разделов должны измениться автоматически.
- Шаг 5. В готовом PDF откройте панель закладок и сопоставьте её структуру с оглавлением. Это различные навигационные механизмы, по этой причине каждый проверяется отдельно.
Для обложки поле cover может ссылаться на изображение или объект с добавочными параметрами. Печатная обложка как страница и изображение обложки электронного пакета — не одно и то же; при нескольких форматах проверяйте оба сценария. Если обложка должна полностью заполнять лист, подготавливайте изображение в нужной пропорции и контролируйте вылет, а не растягивайте случайный растр. Общую процедуру создания документов тоже можно сопоставить с инструкцией по созданию PDF на Xeon Live.
Автоматизация, ускорение сборки и диагностика ошибок
Vivliostyle CLI хорошо ложится в автоматический выпуск именно потому, что все значимые параметры можно хранить в проекте. Надёжная схема фиксирует версию Node.js, зависимость @vivliostyle/cli, lock-файл, шрифты, конфигурацию и команду сборки. Тогда локальный компьютер и CI выполняют одну и ту же последовательность.
npm scripts, пакетная обработка и CI

- Шаг 1. В package.json добавьте сценарии "preview": "vivliostyle preview" и "build": "vivliostyle build". После этого рабочая команда применяет npm run preview и npm run build без зависимости от глобальной установки.
- Шаг 2. Зафиксируйте lock-файл и не обновляйте зависимости перед каждым релизом автоматически. Обновление CLI или темы рассматривайте как изменение версточного окружения и сопровождайте визуальной проверкой.
- Шаг 3. Для серии однотипных документов экспортируйте массив конфигураций или формируйте его JavaScript-кодом. Каждый объект должен иметь собственный вход, наименование и путь итога. Перед запуском очистите каталог output.
- Шаг 4. В CI сперва устанавливайте зависимости из lock-файла, потом запускайте сборку, потом проверяйте существование ожидаемых файлов. Старый PDF не должен пережить неуспешный запуск и выглядеть как новый артефакт.
- Шаг 5. Кэшируйте зависимости и браузер только вместе с идентификатором платформы и lock-файла. После смены версии Node.js или образа контейнера чистая установка должна оставаться эталонным методом диагностики.
- Шаг 6. Для больших серий ограничивайте параллелизм. Несколько тяжёлых книг запускают отдельные браузерные процессы, по этой причине контролируемая очередь часто стабильнее, чем одновременный старт всех заданий.
Ускорять редактирование лучше уменьшением области проверки, а не снижением качества финального PDF. Во время работы откройте одну главу или применяйте --quick, но перед выпуском всегда соберите полный проект. Тяжёлые фотографии уменьшайте до разумного физического размера, сложные SVG очищайте от невидимых объектов, а сетевые шрифты и изображения заменяйте локальными фиксированными копиями, когда требуется повторяемость.
Типичные ошибки и порядок диагностики
- Команда не запускается. Выполните node --version и npm --version, затем npx vivliostyle help. Если глобальная и проектная установки расходятся, применяйте npx или npm script из текущего проекта и сопоставьте версию CLI.
- CSS или изображение не найдено. Проверьте рабочий каталог, относительный путь, регистр имени файла и сгенерированный HTML в workspaceDir. В контейнере ресурс обязан находиться внутри доступного дерева.
- Viewer и PDF отличаются. Исключите --quick, убедитесь, что preview и build читают одну конфигурацию, потом сопоставьте набор шрифтов и локальные ресурсы. Различные среды практически всегда дают различные переносы.
- Номера в оглавлении пусты. Проверьте id заголовков, href ссылок и присутствие целевых глав в одной публикации. Потом выполните полную пагинацию без ускоренного режима.
- Текст выходит за поле. Ищите длинный URL, код с запретом переноса, фиксированную ширину таблицы или white-space: nowrap. Исправляйте проблемный тип элемента, а не уменьшайте шрифт всей книги.
- Сборка долго не завершается. Сократите проект до одной проблемной главы и делите содержимое пополам, пока не отыщете блок. Причиной зачастую становится чрезмерно большой неразрывный элемент, тяжёлый SVG, конфликтующие правила разрыва или зависший сетевой ресурс.
Почему после установки не находится команда vivliostyle?
Проектную установку запускают через npx vivliostyle или npm script. Для глобальной установки каталог исполняемых файлов npm должен быть доступен оболочке. Сперва сопоставьте фактическую версию Node.js и путь запуска.
Почему --quick нельзя применять для финальной проверки?
Этот режим ускоряет загрузку многофайловой публикации за счёт приблизительного расчёта страниц. Окончательные номера, целевые ссылки и поздние разделы проверяют после полной пагинации.
Почему после смены шрифта сдвинулось всё оглавление?
Другая гарнитура меняет ширину символов, переносы и высоту строк. Даже небольшое изменение может сдвинуть десятки страниц, по этой причине после обновления шрифтов необходима полная пересборка.
Почему локальная картинка работает, а в контейнере пропадает?
Контейнер видит только смонтированные каталоги. Переместите ресурс внутрь проекта или явно добавьте каталог в окружение сборки и исправьте относительный путь.
Можно ли править один абзац прямо в готовом PDF?
Рабочий процесс Vivliostyle CLI предполагает правку исходного Markdown, HTML или данных и последующую пересборку. Для точечной правки чужого PDF без исходников необходим PDF-редактор.
Что проверить, если итоговый PDF чрезмерно большой?
Сперва оцените размер растров, встроенных шрифтов и сложных SVG. Уменьшайте конкретные тяжёлые ресурсы, а после внешней оптимизации заново проверяйте ссылки, закладки и читаемость.
Преимущества, недостатки, альтернативы и практический выбор
Vivliostyle CLI наиболее логичен там, где документ уже существует как код и контент: Markdown, HTML, CSS, шаблоны и данные. В таком контексте его главное достоинство — не отдельная функция экспорта, а воспроизводимый конвейер. Версию публикации можно связать с commit, изменения верстки видны в diff, а выпуск повторяется локально и на сервере.

Плюсы
- Текстовые исходники и CSS удобно хранить в системе контроля версий и рецензировать построчно.
- Один проект может выпускать PDF и, для подходящих входов, электронные форматы.
- Параметры страницы, оглавление и колонтитулы автоматизируются вместо ручной правки каждой страницы.
- Vivliostyle Viewer показывает фактическую пагинацию до итогового экспорта.
- Есть темы, VFM, JavaScript API и интеграция с современными фронтенд-процессами.
- Командный интерфейс естественно встраивается в CI и пакетную генерацию документов.
Минусы
- Нет визуального редактора, где макет собирается перетаскиванием блоков мышью.
- Для уверенной настройки печатной верстки необходимы HTML и CSS Paged Media.
- Шрифты, сетевые ресурсы и версия браузерного движка влияют на пагинацию, по этой причине среду надо контролировать.
- Сложные таблицы, крупные неразрывные блоки и нестандартная веб-разметка требуют отдельных тестов на границах страниц.
- Программа не предназначена для OCR и ручной правки уже готового чужого PDF.
Кому подойдёт
- Техническим писателям и командам документации, которые ведут материалы в Markdown или HTML.
- Разработчикам, создающим отчёты и документы из шаблонов и данных.
- Издательским командам, которым подходит верстка через CSS и необходим воспроизводимый выпуск.
- Авторам книг и методичек, работающим с текстовыми исходниками и Git.
Кому лучше выбрать иной инструмент
- Пользователям, которым необходимо ручным способом исправить отдельный элемент в существующем PDF без исходников.
- Дизайнерам, строящим сложный журнальный макет преимущественно визуальными инструментами.
- Задачам OCR, заполнения форм, цифровой подписи и комментирования готовых PDF.
Из близких по идее решений Prince преобразует HTML/XML и CSS в PDF и ориентирован на зрелый печатный конвейер; WeasyPrint удобен в Python-проектах, где HTML/CSS генерируются серверно; Paged.js CLI строит paged media поверх браузерного стека; Antenna House Formatter работает с HTML/CSS и XSL-FO и рассчитан на крупные издательские и документационные процессы. Выбор между ними зависит не от одной функции, а от стека проекта, требований к стандартам, поддержки, формату исходников и степени автоматизации.
Для Vivliostyle CLI рациональная стратегия проста. Если материал живёт в Markdown или HTML и будет обновляться много раз, сперва соберите минимальный PDF, затем перенесите параметры в config, подключите тему и CSS, после этого добавьте оглавление, обложку и автоматизацию. Если задача разовая и состоит в редактировании уже существующего PDF, не стоит восстанавливать весь проект ради одной правки. А когда готовый файл получился чрезмерно тяжёлым, полезно отдельно изучить способы уменьшить размер PDF и после оптимизации ещё раз проверить документ.
В результате Vivliostyle CLI лучше всего раскрывается не как разовый конвертер, а как часть управляемой публикационной системы. Стабильный проект хранит рукопись, ресурсы, стили, конфигурацию и зависимости рядом; preview применяется для контрольной пагинации, build — для выпуска, а автоматизация повторяет тот же сценарий на сервере. Такой подход требует дисциплины, зато после настройки позволяет выпускать длинные материалы без ручного обслуживания каждой страницы.