Jekyll Документация к PDF с TOC

Question

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

Часть HTML проста, но я хотел бы использовать CSS @Media Print CSS для создания файла PDF.

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

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

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

Кстати. Построение решил эту проблему, используя Princexml..

Answer 1

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

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

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

Answer 2

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

Answer 3

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