Jekyll Dokumentation PDF mit TOC

Question

Ich möchte schreiben Dokumentation mit Hilfe von Jekyll mit HTML und PDF-Ausgaben. Html kann eine Navigation, aber die PDF sollte Inhaltsverzeichnis haben. Gibt es eine kostenlose und einfache Möglichkeit, das zu tun?

Der HTML-Teil ist einfach, aber ich möchte CSS verwenden @media Drucken der PDF-Datei zu machen.

Ich habe ein paar Ideen, wie dies zu tun.

1. Verwenden Sie PrinceXML , leider ist das Handelsprodukt mit einem heftigen Preisschild ~ 500 $
2. Verwenden Sie wkhtmltopdf
3. Verwenden Sie Maruku , da es möglich ist, eine PDF-Konvertierung, es zu tun mit

Ich möchte mehrere Seiten haben HTML und einzelne Seite PDF mit einem TOC. Irgendwelche Vorschläge?

Btw. Buildr dieses Problem wurde gelöst mit PrinceXML .

Answer 1

Wenn ‚frei‘ ist Ihr wichtigstes Kriterium, als wkhtmltopdf ist die beste Wahl. Es unterstützt Dinge wie Decken, toc, Kopf- und Fußzeilen und Abschnitte. Je nachdem, wie exotische das Layout des Dokuments wird, werden Sie wahrscheinlich in einigen page-break Probleme laufen, aber mit ein wenig Bastelei Sie sollten in Ordnung sein.

Ich habe ein bisschen mit wkhtmltopdf jetzt, mit einigen ziemlich komplizierten Dokumenten (mit Javascript Diagramme, Tabellen, svg Bildern, etc.) und nicht in zu vielen Probleme lief.

Stellen Sie sicher, verwenden Sie die statische Version von wkhtmltopdf, da es die einzige Version ist, die Träger einer TOC-Seite zu machen.

Answer 2

• Für ein Inhaltsverzeichnis mit Jekyll zu erzeugen, können Sie verwenden, um die {:toc} Makro von Abschlag angeboten werden, oder schreiben Sie Ihren eigenen Textil Tisch wenn Sie Inhaltsfilter lieber Verwendung Textil ..
• Für ein PDF von HTML und CSS zu erzeugen, habe ich weasyprint eine gute Lösung zu sein. Da sie auf einem externen Motor nicht für Rendering verlassen, hängen sie nicht auf ausländische Straßenkarten des Projekts für relevante Funktionen wie CSS generierte Inhalte oder @page CSS-Deklarationen zu implementieren. (Aber im Gegensatz zu wkhtmltopdf, weasyprint nicht Parse Javascript).

Answer 3

Sie können das PDFKit Juwel, das wkhtmltopdf hinter den Kulissen verwendet. Dann können Sie Ihre PDF-Logik in einer Jekyll-Plugin als Generator oder Konverter setzen.