wkhtmltopdf如何使用

wkhtmltopdf 是一个开源的命令行工具，它可以将网页内容转换成PDF文件，该工具基于WebKit引擎（也是Safari浏览器的核心），因此它能很好地处理CSS和JavaScript，使得转换后的PDF能够保持网页的原有样式，以下是如何使用 wkhtmltopdf 的详细技术教学：

安装 wkhtmltopdf

在Windows上安装

1、访问 wkhtmltopdf 官方网站或其GitHub仓库获取最新版下载链接。

2、下载安装包后，双击运行安装程序并遵循指示完成安装。

在Linux上安装

对于基于Debian的系统（如Ubuntu），可以使用以下命令安装：

sudo aptget install wkhtmltopdf

对于其他发行版，请参照相应的包管理器进行安装。

在macOS上安装

可以使用Homebrew进行安装：

brew install wkhtmltopdf

或者下载wkhtmltopdf的macOS版本的安装包，并按照提示进行安装。

使用 wkhtmltopdf

基本用法

最基本的使用方法是直接在命令行中输入：

wkhtmltopdf input.html output.pdf

input.html 是你想要转换的网页文件，output.pdf 是生成的PDF文件。

选项和参数

wkhtmltopdf 支持多种选项来定制输出的PDF。

pagesize 设置页面大小，如 A4、Letter。

margintop、marginright、marginbottom 和 marginleft 设置页边距。

headerhtml 和 footerhtml 添加自定义的页眉和页脚。

zoom 设置页面缩放比例。

nooutline 禁用PDF中的目录结构。

javascriptdelay 设置JavaScript执行延迟时间。

示例

以下命令将一个网页转换为A4大小的PDF，设置左、右、下、上的页边距分别为10mm，并在每页的页脚处添加一段文字：

wkhtmltopdf pagesize A4 margintop 10mm marginright 10mm marginbottom 10mm marginleft 10mm footerhtml footer.html input.html output.pdf

高级用法

wkhtmltopdf 还支持通过HTTP或HTTPS协议将在线网页转换为PDF，你可以直接指定URL作为输入：

wkhtmltopdf pagesize A4 http://example.com/ myfile.pdf

故障排除

如果遇到问题，首先确保你的wkhtmltopdf是最新版本，因为旧版本可能存在兼容性问题或者不支持某些新特性，检查是否有错误日志输出，通常它会告诉你出错的原因，确保网页中使用的所有资源（如图片、字体、外部CSS或JS）都是可访问的。

归纳来说，wkhtmltopdf 是一个功能强大且灵活的工具，可以满足大多数网页转PDF的需求，掌握它的基本和高级用法，可以帮助你高效地完成日常文档转换任务。