Dẫn nhập
Tôi có một bài viết trước đây , bài viết tiếp theo này tôi sẽ giới thiệu với các bạn một thư viện của Python là pdfkit (dựa trên enginee của wkhtmktopdf) để thực hiện chuyển đổi file html đã tạo được sang file pdf.
Lựa chọn pdfkit ?
Trước khi dùng pdfkit, tôi đã tìm hiểu và sử dụng một loạt các thư viện khác như html2pdf, xhtml2pdf,…các thư viện này nhẹ và dễ dùng hơn pdfkit rất nhiều nhưng có một thứ mà pdfkit (wkhtmltopdf) làm được mà các thư viện khác không làm được (đến thời điểm tôi tham khảo) đó là xử lý dữ liệu tiếng Việt (unicode).
pdfkit có thể thực hiện convert chính xác tiếng Việt có dấu từ html ra pdf. Còn các thư viện khác thì… hên xui, có ký tự có dấu xử lý được, có ký tự thì ô vuông, hỏi chấm.
Cài đặt thư viện
Pdfkit sử dụng enginee do thư viện wkhtmltopdf cung cấp. Để sử dụng được pdfkit thì ta phải cài đặt wkhtmltopdf trước.
Cài đặt wkhtmltopdf
Đây là một opensoucce, chúng ta có thể download tại https://wkhtmltopdf.org/index.html, chú ý download đúng phiên bản tương ứng với hệ điều hành mà bạn đang sử dụng.
Riêng với hệ điều hành Windows, khi cài đặt các bạn nhớ lưu ý đường dẫn đến vị trí cài đặt của của wkhtmltopdf (thường là C:Program Fileswkhtmltopdf).
Sau đó, thực hiện mở thư mục chứa đường dẫn này vào vào thư mục con sâu hơn là bin (C:Program Fileswkhtmltopdfbin) vào class-path của windows. Việc cài đặt PATH, các bạn có thể tìm kiếm trên google nhé.
Sau khi cài đặt & set class path xong, bạn hãy mở windows terminal (mở cmd mới nhé) ra và gõ vào dòng lệnh sau:
wkhtmltopdf --version
wkhtmltopdf 0.12.5 (with patched qt)
Nếu có dữ liệu như trên thì có nghĩa là việc cài đặt wkhtmltopdf đã thành công.
Với hệ điều hành Linux, nếu user của bạn không phải là root, hãy thực hiện set đường dẫn đến thư mục chứa class của wkhtmltopdf để có thể sử dụng wkhtmltopdf trên commandline nhé.
Cài đặt pdfkit.
Sử dụng câu lệnh sau để cài đặt pdfkit
1 2 | pip install pdfkit |
Kết quả hiện ra:
1 2 3 4 5 | Collecting pdfkit Downloading pdfkit-0.6.1-py3-none-any.whl (12 kB) Installing collected packages: pdfkit Successfully installed pdfkit-0.6.1 |
Sử dụng pdfkit với Python
Thư viện pdfkit cung cấp khá đầy đủ các sample, các bạn có thể tham khảo thêm tại: https://pypi.org/project/pdfkit/
Sử dụng các các chức năng mặc định.
Convert một trang web sang pdf
Mở terminal, di chuyển đến một thư mục … “dễ nhớ”và thực hiện một số dòng lệnh sau: (Nhớ chuyển từ terminal sang mode python bằng cách gõ python trước nhé)
1 2 3 4 | <span class="token operator">>></span><span class="token operator">></span> <span class="token keyword">import</span> pdfkit <span class="token operator">>></span><span class="token operator">></span> pdfkit<span class="token punctuation">.</span>from_url<span class="token punctuation">(</span><span class="token string">"https://viblo.asia/newest"</span><span class="token punctuation">,</span> <span class="token string">"url2pdf.pdf"</span><span class="token punctuation">)</span> |
Sau đó đợi thư viện làm việc và phản hồi lại.
1 2 3 4 5 6 7 8 | Loading pages (1/6) Counting pages (2/6) Resolving links (4/6) Loading headers and footers (5/6) Printing pages (6/6) Done True |
Như này là kết quả đã thành công, mở thư mục vừa di chuyển đến, ta sẽ thấy file url2pdf.pdf
Convert một file html sang pdf
Trước tiên, thực hiện tạo ra một file .html và đặt nó vào một thư mục, trong ví dụ này, tôi dùng file có tên report.html.
Mở terminal và thực hiện di chuyển đến thưc mục chứa file report.html, sau đó chuyển sang mode nhập code python
1 2 3 | <span class="token operator">>></span><span class="token operator">></span> <span class="token keyword">import</span> pdfkit <span class="token operator">>></span><span class="token operator">></span> pdfkit<span class="token punctuation">.</span>from_file<span class="token punctuation">(</span><span class="token string">'report.html'</span><span class="token punctuation">,</span> <span class="token string">'report.pdf'</span><span class="token punctuation">)</span> |
Chờ một chút để hệ thống xử lý và đưa ra thông báo.
1 2 3 4 5 6 7 8 | Loading pages (1/6) Counting pages (2/6) Resolving links (4/6) Loading headers and footers (5/6) Printing pages (6/6) Done True |
Sau đó ta có thể mở file report.pdf để xem kết quả convert:
Lưu ý: để có thể convert đúng dữ liệu unicode thì là file .html phải có thẻ <meta> với nội dung như bên dưới đặt tại thẻ <head>
1 2 | <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>meta</span> <span class="token attr-name">http-equiv</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>Content-Type<span class="token punctuation">"</span></span> <span class="token attr-name">content</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>text/html; charset=utf-8<span class="token punctuation">"</span></span> <span class="token punctuation">/></span></span> |
Convert một đoạn text sang pdf
1 2 3 | <span class="token operator">>></span><span class="token operator">></span> <span class="token keyword">import</span> pdfkit <span class="token operator">>></span><span class="token operator">></span> pdfkit<span class="token punctuation">.</span>from_string<span class="token punctuation">(</span><span class="token string">"convert dữ liệu string sang pdf"</span><span class="token punctuation">,</span> <span class="token string">"string.pdf"</span><span class="token punctuation">)</span> |
Chờ một chút để hệ thống xử lý và đưa ra thông báo.
1 2 3 4 5 6 7 8 | Loading pages (1/6) Counting pages (2/6) Resolving links (4/6) Loading headers and footers (5/6) Printing pages (6/6) Done True |
Sau đó ta có thể mở file string.pdf để xem kết quả convert –> Lỗi font chữ unicode
Để giải quyết việc này, pdfkit cho phép các bạn thực hiện khai báo thêm một số “cấu hình”.
1 2 3 | options = {'encoding': "UTF-8"} pdfkit.from_string("convert dữ liệu string sang pdf", 'string_unicode.pdf', options=options) |
Kết quả thu được:
pdfkit cung cấp khá nhiều các tham số cấu hình khác dựa trên bộ tham số của wkhtmltopdf. Chúng ta sẽ làm quen với một số tham số ở phần tiếp theo.
Thêm một chút nâng cao với pdfkit
Thay đổi các cấu hình mặc định.
Pdfkit cung cấp việc thay đổi một số tham số cầu hình thường gặp giống như lúc chúng ta cấu hình in một văn bản ra máy in văn phòng:
1 2 3 4 5 6 7 8 9 10 11 12 | options <span class="token operator">=</span> <span class="token punctuation">{</span> <span class="token string">'page-size'</span><span class="token punctuation">:</span> <span class="token string">'A4'</span><span class="token punctuation">,</span> <span class="token string">'orientation'</span><span class="token punctuation">:</span> <span class="token string">'Portrait'</span><span class="token punctuation">,</span> <span class="token string">'quiet'</span><span class="token punctuation">:</span> <span class="token string">''</span><span class="token punctuation">,</span> <span class="token string">'dpi'</span><span class="token punctuation">:</span> <span class="token number">96</span><span class="token punctuation">,</span> <span class="token string">'margin-top'</span><span class="token punctuation">:</span> <span class="token string">'0.2in'</span><span class="token punctuation">,</span> <span class="token string">'margin-bottom'</span><span class="token punctuation">:</span> <span class="token string">'0.2in'</span><span class="token punctuation">,</span> <span class="token string">'margin-right'</span><span class="token punctuation">:</span> <span class="token string">'0.72in'</span><span class="token punctuation">,</span> <span class="token string">'margin-left'</span><span class="token punctuation">:</span> <span class="token string">'0.72in'</span><span class="token punctuation">,</span> <span class="token string">'encoding'</span><span class="token punctuation">:</span> <span class="token string">"UTF-8"</span> <span class="token punctuation">}</span> |
page-size: Khổ giấy của file pdf sau khi convert. Mặc định là A4, có thể thay đổi thành cách giá trị Letter, A5,…
orientation: Mặc định là khổ giấy xoay dọc (Portrait), có thể thay đổi sang xoay ngang (Landscape)
quiet: Hiển thị log trong quá trình convert sang pdf. Giá trị ưng với các level đặt log (INFO, WARNING,…). Thường đặt ” trên production để tránh lỗi hiển thị terminal.
dpi: Dots Per Inch – Độ đậm nét của ký tự trên file pdf. Mặc định là 96. Tham số này không nên thay đổi. Với Windows, UNIX thì wkhtmltopdf sẽ reset về 96pdi, nếu chuyển qua convert trên máy OSX thì mới có thể tăng số lượng dpi lên được.
margin-: Giãn cách từ vị trí các mép tương ứng đến phần dữ liệu đầu tiên của nội dung của file. Tùy theo nhu cầu mà chúng ta thay đổi hoặc giữ nguyên mặc định.
Các tham số khác (enable/disable css, javascript, …), các bạn có thể tham khảo thêm từ help của wkhtmltopdf
1 2 | wkhtmltopdf -H |
Xử lý trường hợp không có quyền thiết lập $path
Đôi khi bạn không có quyền thực hiện set $PATH trên hệ thống mà vẫn muốn dùng luôn pdfkit, pdfkit sẽ cung cấp một tham số để bạn thực hiện trỏ đường dẫn đến vị trí cài đặt wkhtmltopdf.
Để xem đường dẫn của thư viện wkhtmltopdf, trên Unix, bạn gõ
1 2 | which wkhtmltopdf |
/usr/local/bin/wkhtmltopdf
Trên windows thì dùng tính năng search để tìm xem file wkhtmltopdf.exe ở đâu. Sao chép đường
1 2 3 4 | wkhtmltopdf_path <span class="token operator">=</span> <span class="token string">"/usr/local/bin/wkhtmltopdf"</span> path_config <span class="token operator">=</span> pdfkit<span class="token punctuation">.</span>configuration<span class="token punctuation">(</span>wkhtmltopdf<span class="token operator">=</span>wkhtmltopdf_path<span class="token punctuation">)</span> pdfkit<span class="token punctuation">.</span>from_file<span class="token punctuation">(</span>html_file_path<span class="token punctuation">,</span> pdf_file_path<span class="token punctuation">,</span> options<span class="token operator">=</span>options<span class="token punctuation">,</span> configuration<span class="token operator">=</span>config<span class="token punctuation">)</span> |
Việc trỏ config trực tiếp này sẽ giúp chúng ta ignore được các lỗi:
IOError: ‘No wkhtmltopdf executable found’
OSError: ‘No wkhtmltopdf executable found’
Convert nhiều nội dung và chung một file.
Đây là một tính năng khá hay của pdfkit. Dưới đây là một ví dụ, thực hiện nối ghép các trang web vào một file cuối cùng.
1 2 3 | <span class="token keyword">import</span> pdfkit pdfkit<span class="token punctuation">.</span>from_url<span class="token punctuation">(</span><span class="token punctuation">[</span><span class="token string">'google.com'</span><span class="token punctuation">,</span> <span class="token string">'viblo.asia'</span><span class="token punctuation">,</span> <span class="token string">'https://viblo.asia/newest'</span><span class="token punctuation">]</span><span class="token punctuation">,</span> <span class="token string">'concat_web.pdf'</span><span class="token punctuation">)</span> |
Các bạn có thể làm tương tự với các function .from_string(), .from_file()
Một bài viết ngắn giới thiệu một thư viện nho nhỏ. Cảm ơn các bạn đã đọc bài của tôi!