documentation au format PDF Jekyll avec TOC

Question

Je voudrais écrire la documentation en utilisant Jekyll avec des sorties HTML et PDF. Html peut avoir une navigation mais le PDF devrait avoir la table des matières. Est-il un moyen gratuit et facile à faire?

La partie HTML est facile, mais je voudrais utiliser @media imprimer CSS pour rendre le fichier PDF.

J'ai quelques idées sur la façon de le faire.

1. PrinceXML , malheureusement, c'est produit commercial avec une étiquette de prix méchant ~ 500 $
2. WKHTMLTOPDF
3. Maruku , car il est possible de faire une conversion PDF utilisant

Je voudrais avoir plusieurs pages HTML et PDF d'une seule page avec une table des matières. Aucune suggestion?

BTW. Buildr a résolu ce problème en utilisant PrinceXML .

Answer 1

Si « libre » est votre critère le plus important, que wkhtmltopdf est votre meilleur pari. Il prend en charge les choses comme couvertures, toc, en-têtes, pieds de page et les sections. Selon la façon dont exotique la mise en page de votre document sera, vous aurez probablement rencontrer quelques problèmes de saut de page, mais avec un peu de vous bricoler devriez être bien.

Je me sers wkhtmltopdf pour un peu maintenant, avec quelques documents assez complexes (avec des graphiques javascript, tableaux, images svg, etc.) et n'ont pas courir dans trop de problèmes.

Assurez-vous d'utiliser la version statique de wkhtmltopdf, car il est la seule version qui supporte le rendu d'une page de table des matières.

Answer 2

• Pour générer une table des matières en utilisant Jekyll, vous pouvez utiliser la macro {:toc} offert par Markdown, ou écrivez votre propre table textile du contenu filtre si vous préférez utiliser textile ..
• Pour générer un PDF à partir Html et CSS, j'ai trouvé weasyprint pour être une bonne solution. Comme ils ne reposent pas sur un moteur externe pour le rendu, ils ne dépendent pas des feuilles de route du projet à l'étranger pour mettre en œuvre les caractéristiques pertinentes telles que le contenu généré par CSS ou @page déclarations CSS. (Mais contrairement à wkhtmltopdf, weasyprint ne parse pas javascript).

Answer 3

Vous pouvez utiliser le PDFKit joyau, qui utilise wkhtmltopdf dans les coulisses. Ensuite, vous pouvez mettre votre logique PDF dans un plugin Jekyll comme un générateur ou convertisseur.