带有TOC的Jekyll PDF文档

Question

我想用Jekyll编写带有HTML和PDF输出的文档.Html可以有导航,但PDF应该有目录.有一种免费且简单的方法吗？

HTML部分很简单,但我想使用@media print CSS制作PDF文件.

我有一些想法如何做到这一点.

1. 使用PrinceXML,不幸的是这是商品,价格很贵〜$ 500
2. 使用WKHTMLTOPDF
3. 使用Maruku,因为可以使用它进行PDF转换

我想有多页HTML和单页PDF与TOC.有什么建议？

顺便说一句.Buildr使用PrinceXML解决了这个问题.

Answer 1

如果"免费"是您最重要的标准,那么wkhtmltopdf是您最好的选择.它支持cover,toc,header,footers和sections之类的东西.根据文档布局的异乎寻常程度,您很可能会遇到一些分页问题,​​但稍微修改一下就应该没问题.

我现在一直在使用wkhtmltopdf,有一些非常复杂的文档(使用javascript图表,表格,svg图像等)并且没有遇到太多问题.

请确保使用静态版本的wkhtmltopdf,因为它是唯一支持呈现TOC页面的版本.