wkhtmltox详解

小蓝 • 2024-12-03 13:28 • 编程

一、什么是 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 和图片等多种格式。虽然其存在一些缺点，但其优点依然很突出，可以在很多方面为开发者提供便利。

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/197296.html