documentación Jekyll a PDF con TOC

Question

Me gustaría documentación de escritura usando Jekyll con HTML y PDF salidas. Html puede tener una navegación pero el PDF debe tener la tabla de contenidos. ¿Hay una manera libre y fácil de hacer eso?

La parte HTML es fácil, pero me gustaría utilizar @media imprimir CSS para hacer que el archivo PDF.

Tengo algunas ideas de cómo hacer esto.

1. PrinceXML , por desgracia, este es un producto comercial con una etiqueta de precio desagradable ~ $ 500
2. wkhtmltopdf
3. Maruku , ya que es posible hacer una conversión de PDF a usarlo

Me gustaría tener múltiples páginas HTML y PDF de una sola página con una tabla de contenido. ¿Alguna sugerencia?

Por cierto. Buildr ha resuelto este problema utilizando PrinceXML .

Answer 1

Si 'libre' es el criterio más importante, que wkhtmltopdf es su mejor apuesta. Es compatible con cosas como cubiertas, toc, encabezados, pies y secciones. Dependiendo de qué tan exótico será el diseño del documento, es muy probable que encuentre algunos problemas de salto de página, pero con un poco de bricolaje que debe estar bien.

He estado usando wkhtmltopdf para un poco ahora, con algunos documentos bastante complicado (con gráficos de Javascript, tablas, imágenes SVG, etc.) y no se han topado con demasiados problemas.

Asegúrese de que utiliza la versión estática de wkhtmltopdf, ya que es la única versión cuales soportes representación de una página TOC.

Answer 2

• Para generar una tabla de contenido utilizando Jekyll, puede utilizar la macro {:toc} ofrecido por reducción del precio, o escribir su propio del filtro de contenidos si lo prefiere para uso textil ..
• Para generar un PDF de HTML y CSS, he encontrado weasyprint a ser una buena solución. Ya que no se basan en un motor externo para la representación, que no dependen de las hojas de ruta de proyectos en el exterior para la implementación de características relevantes, tales como CSS generado contenido o @page CSS-declaraciones. (Sin embargo, en contraste con wkhtmltopdf, weasyprint hace javascript no analiza).

Answer 3

Puede utilizar el href="https://github.com/pdfkit/PDFKit" rel="nofollow"> PDFKit gema