documentazione Jekyll in PDF con TOC

Question

Vorrei documentazione scrittura utilizzando Jekyll con HTML e PDF uscite. HTML può avere una navigazione ma il PDF dovrebbe avere sommario. C'è un modo semplice e gratuito per farlo?

La parte HTML è facile, ma vorrei utilizzare @media stampare CSS per rendere il file PDF.

Ho un paio di idee su come fare questo.

1. PrinceXML , purtroppo questo è prodotto commerciale con un prezzo brutto ~ $ 500
2. wkhtmltopdf
3. Maruku , dal momento che è possibile fare una conversione PDF usando

Mi piacerebbe avere più pagine HTML e singola pagina PDF con un sommario. Eventuali suggerimenti?

Btw. Buildr ha risolto questo problema utilizzando PrinceXML .

Answer 1

Se 'libero' è il tuo criterio più importante, rispetto wkhtmltopdf è la soluzione migliore. Supporta le cose come coperte, toc, intestazioni, piè di pagina e sezioni. A seconda di come esotica il layout del documento sarà, molto probabilmente verrà eseguito in alcuni problemi page-break, ma con un po 'di ritocchi si dovrebbe andare bene.

Ho usato wkhtmltopdf per un po 'ora, con alcuni documenti piuttosto complicato (con grafici javascript, tabelle, immagini SVG, etc.) e non ho incontrato troppi problemi.

Assicurarsi di utilizzare la versione statica di wkhtmltopdf, in quanto è l'unica versione che supporta il rendering di una pagina di TOC.

Answer 2

• Per la generazione di un sommario che utilizza Jekyll, puoi utilizzare la macro {:toc} offerto dal mark-down, o lascia la tua filtro contenuti , se si preferisce uso tessile ..
• per generare un PDF da HTML e CSS, ho trovato weasyprint per essere una buona soluzione. Dal momento che non si basano su di un motore esterno per il rendering, non dipendono dalla roadmap del progetto estero per l'attuazione di funzioni rilevanti quali CSS contenuti generati o @page CSS-dichiarazioni. (Ma a differenza di wkhtmltopdf, weasyprint fa JavaScript non parse).

Answer 3

È possibile utilizzare la PDFKit gemma, che utilizza wkhtmltopdf dietro le quinte. Poi si può mettere la vostra logica PDF in un plugin Jekyll come un generatore o convertitore.