wkhtmltox詳解

一、什麼是 wkhtmltox？

wkhtmltox 是一個開源的命令行工具，可以將 HTML 轉換成 PDF 和各種圖像格式。它是基於 QT 和 WebKit 開發的，支持多種操作系統，比如 Windows、Linux 和 Mac OS X。wkhtmltox 使用簡單，無需進行安裝，只需執行二進位文件即可。

二、常見 wkhtmltox 命令

1. 將 HTML 轉換成 PDF

以下是將 HTML 字元串轉換成 PDF 文件的 wkhtmltopdf 命令示例：

wkhtmltopdf "http://www.baidu.com" baidu.pdf

上述命令會將百度首頁轉換成 PDF 格式，輸出為 baidu.pdf 文件。

2. 將 HTML 轉換成圖片

以下是將 HTML 字元串轉換成 PNG 圖片文件的 wkhtmltoimage 命令示例：

wkhtmltoimage "http://www.baidu.com" baidu.png

上述命令會將百度首頁轉換成 PNG 格式的圖片，輸出為 baidu.png 文件。

3. 添加頁眉和頁腳

wkhtmltopdf 支持在 PDF 中添加頁眉和頁腳，以下是添加頁眉和頁腳的示例：

wkhtmltopdf --header-html header.html --footer-html footer.html "http://www.baidu.com" baidu.pdf

上述命令會使用 header.html 中的內容作為頁眉，使用 footer.html 中的內容作為頁腳。

4. 設置紙張大小和方向

wkhtmltopdf 默認紙張大小是 A4，紙張方向是豎向。可以通過以下命令設置紙張大小和方向：

wkhtmltopdf --page-size A5 --orientation Landscape "http://www.baidu.com" baidu.pdf

上述命令會將紙張大小設置為 A5，紙張方向設置為橫向。

5. 設置 PDF 文件的屬性

可以通過以下命令設置 PDF 文件的屬性，比如作者、主題、關鍵字等：

wkhtmltopdf --title "百度首頁" --author "百度" --keywords "搜索引擎" "http://www.baidu.com" baidu.pdf

上述命令會將 PDF 文件的標題設置為「百度首頁」，作者設置為「百度」，關鍵字設置為「搜索引擎」。

三、如何安裝 wkhtmltox

wkhtmltox 工具非常容易安裝，只需要下載對應平台的二進位文件即可。以下是 Windows 平台的安裝步驟：

1. 下載 Windows 版本的二進位文件，可以到官網下載： https://wkhtmltopdf.org/downloads.html

2. 解壓縮下載的文件，將 bin 文件夾加入系統 PATH。此時在命令行窗口輸入 wkhtmltopdf 命令即可使用。

四、如何使用 wkhtmltox 進行開發

wkhtmltox 工具支持多種編程語言調用，比如 PHP、Java、Python 等。以下是一個 PHP 調用示例：

$html = "<p>Hello, World!</p>";
$output_file = "output.pdf";
$cmd = "wkhtmltopdf -q \"$html\" \"$output_file\"";
exec($cmd);

上述代碼會將 $html 轉換成 PDF 文件，並輸出為 $output_file。

五、wkhtmltox 的優缺點

1. 優點

• 支持多種操作系統，適用範圍廣。
• 支持多種輸出格式，比如 PDF、PNG、JPEG 等。
• 使用簡單，無需進行安裝。
• 輸出的 PDF 文件質量高，支持添加頁眉和頁腳。

2. 缺點

• 轉換速度較慢，需要等待一段時間。
• 轉換過程中可能會出現失敗，需要重新執行。
• 對於一些 HTML 標籤支持不夠好，可能會導致轉換不完全。

六、總結

wkhtmltox 是一個非常實用的命令行工具，可以將 HTML 快速轉換成 PDF 和圖片等多種格式。雖然其存在一些缺點，但其優點依然很突出，可以在很多方面為開發者提供便利。