Thinking more...: pdfkit/wkhtmltopdf

wkhtmltopdf 是一個可以將網址或是 HTML 檔案轉換為 PDF 的程式。
pdfkit 則是一個 python package (或 library)，用來將網址或是 HTML 轉換為 PDF，底層用的是 wkhtmltopdf 。
django-pdfkit 則是給 Django 使用的 app，主要使用 pdfkit ，提供了 PDFView 。要提供產出 PDF 的網頁，只要寫一個繼承自 PDFView 的 View，撰寫 template ，就可以了。
以下是幾個試過以後的心得：

內部處理順序是先使用 Django template 輸出為 HTML，再用 pdfkit 輸出為 PDF。
預設用 PATH 去找 wkhtmltopdf，但如果有指定 WKHTMLTOPDF_BIN 這個環境變數的話，就用這裏面的。
在網址加入 html 參數，表示顯示 HTML，例如：http://server/show_pdf/?html
在網址加上 inline 參數，表示直接顯示 PDF，而非下載，例如：http://server/show_pdf/?inline
要自訂 pdfkit 使用 wkhtmltopdf 的參數，在繼承的 View 裡加入 pdfkit_options (型態為 dict) 或是自訂 get_pdfkit_options method。
要自訂輸出的檔名，可以在繼承的 View 裡加入 filename 或是自訂 get_filename method。
wkhtmltopdf 預設不使用 print media-type ，所以在 css 裡加的 print media-type 相關樣式都沒用，除非自訂 pdfkit_options ，加入 {"print-media-type": ""}。雖然加了 print-media-type 可以強制讓 wkhtmltopdf 參考 print media-type，但是一般可以在網路上查到，使用 print media-type 在每頁加頁次的方法是行不通的，一樣要自訂 pdfkit_options 才行 (參考 wkhtmltopdf -h 說明)：{ 'footer-center': '[page] / [toPage]'}。其他還有調頁面邊界、紙張大小的，也都是要看 wkhtmltopdf 的說明來調整 pdfkit_options 。
bootstrap 3 本身就有支援 print media-type ，直接使用就會有不錯的效果。如果要更漂亮，可以參考 Natshah/bootstrap-print: To manage print media for Twitter Bootstrap v3.

表格跨頁標題主要是使用 table/thead/tbody 跟調整 css，之前參考的網頁找不到了，這裡直接貼相關的 css 跟 html：

/* CSS */
@media print {
  table {display:table;}
  thead {display:table-header-group!important;page-break-after:avoid!important;}
  tbody {display:table-row-group!important;page-break-after: auto!important;}
  tr, img {display:table-row!important;page-break-inside:avoid!important;page-break-after: auto!important;}
  td, th {display:table-cell!important;}
}



  

        編號
        姓名
    

  

        1
        王小明

Thinking more...

星期一, 10月 16, 2017

pdfkit/wkhtmltopdf

沒有留言: