2010-04-09 102 views
13

我想使用Jekyll來編寫HTML和PDF格式的文檔。 Html可以有導航,但PDF應該有目錄。有沒有一個自由和簡單的方法來做到這一點?Jekyll將文檔轉換爲PDF格式TOC

HTML部分很簡單,但我想使用@media print CSS來製作PDF文件。

我有一些想法如何做到這一點。

  1. 使用PrinceXML,可惜這是商業產品,一個討厭的價碼〜$ 500強
  2. 使用WKHTMLTOPDF
  3. 使用Maruku,因爲可以使用它

我做一個PDF轉換希望擁有多個頁面HTML和單頁面PDF以及TOC。有什麼建議麼?

Btw。 Buildr已使用PrinceXML解決了此問題。

+0

我幾乎從喜悅中跳出座位,以爲Prince變得這麼便宜,但500美元實際上是單電腦,單用戶,交互式使用..它仍然是服務器許可證3800美元(及以上)。 – Nenotlep 2012-07-12 07:17:14

+0

Maruku的強制鏈接https://github.com/bhollis/maruku – 2013-11-21 22:29:12

回答

5

如果'自由'是你最重要的標準,那麼wkhtmltopdf是你最好的選擇。它支持封面,toc,頁眉,頁腳和部分等內容。根據你的文檔佈局有多奇妙,你很可能會遇到一些分頁問題,​​但有點修補你應該沒問題。

我一直在使用wkhtmltopdf,現在有一些非常複雜的文檔(包括javascript圖表,表格,svg圖像等),並沒有遇到太多問題。

確保您使用wkhtmltopdf的靜態版本,因爲它是支持呈現TOC頁面的唯一版本。

+0

嗨,彼得,我對wkhtmltopdf也有很好的體驗,因爲它的確功能非常豐富。雖然只有一個問題,顯然很小但非常重要:標題後的分頁符。任何經驗你必須分享? (https://github.com/wkhtmltopdf/wkhtmltopdf/issues/1551#issuecomment-46580202) – Ernesto 2014-06-19 19:55:30

2

您可以使用PDFKit寶石,它在後臺使用wkhtmltopdf。然後,您可以將您的PDF邏輯作爲發電機或轉換器放入Jekyll插件中。

2
  • 對於使用傑奇生成的目錄,你可以通過use the {:toc} macro降價提供,或者自己寫textile table of contents filter,如果你喜歡用紡織品..
  • 爲了生成HTML和CSS一個PDF,我已經找到weasyprint是一個很好的解決方案。由於他們不依賴於外部引擎進行渲染,因此他們不依賴於外部項目的路線圖來實現CSS生成的內容或CSS聲明等相關功能。 (但與wkhtmltopdf相反,weasyprint不解析javascript)。