Документация Jekyll в PDF с оглавлением

Question

Я хотел бы написать документацию, используя Jekyll с выводами HTML и PDF. HTML может иметь навигацию, но PDF должен иметь оглавление. Есть ли бесплатный и простой способ сделать это?

HTML-часть проста, но я хотел бы использовать @media print CSS для создания PDF-файла.

У меня есть несколько идей, как это сделать.

1. Используйте PrinceXML , к сожалению, это коммерческий продукт с неприятным ценником ~ 500
2. Использование WKHTMLTOPDF
3. Используйте Maruku , поскольку с его помощью можно конвертировать PDF

Я бы хотел иметь несколько страниц HTML и одну страницу PDF с оглавлением. Какие-либо предложения?

Btw. Buildr решил эту проблему с помощью PrinceXML .

Answer 1

Если «бесплатный» - это ваш самый важный критерий, тогда wkhtmltopdf - ваш лучший выбор. Он поддерживает такие вещи, как обложки, ток, колонтитулы и разделы. В зависимости от того, насколько экзотичным будет макет вашего документа, вы, скорее всего, столкнетесь с некоторыми проблемами, связанными с разрывом страниц, но с небольшими изменениями все будет в порядке.

Я уже некоторое время использую wkhtmltopdf, с некоторыми довольно сложными документами (с диаграммами javascript, таблицами, изображениями svg и т. Д.), И у меня не было слишком много проблем.

Убедитесь, что вы используете статическую версию wkhtmltopdf, поскольку это единственная версия, которая поддерживает отображение страницы оглавления.

Answer 2

• Для создания оглавления с помощью Jekyll, вы можете использовать {:toc} макрос , предлагаемый уценкой, или написать собственный текстильный фильтр оглавления , если вы предпочитаете использовать текстильный ..
• Для создания PDF из HTML и CSS я нашел weasyprint как хорошее решение. Поскольку они не полагаются на внешний движок для рендеринга, они не зависят от дорожных карт стороннего проекта для реализации соответствующих функций, таких как сгенерированный CSS контент или @page CSS-объявления. (Но в отличие от wkhtmltopdf, weasyprint не анализирует javascript).

Answer 3

Вы можете использовать гем PDFKit , который использует wkhtmltopdf за кулисами. Затем вы можете поместить свою логику PDF в плагин Jekyll в качестве генератора или конвертера.