wkhtmltopdf是什么|极客教程

wkhtmltopdf是什么

简介

wkhtmltopdf是一个开源的命令行工具，用于将HTML文件或网页转换为PDF文件。它是通过Webkit引擎进行渲染的，能够实现高质量的转换效果。

wkhtmltopdf提供了多种自定义选项，让用户根据自己的需求进行PDF文件的生成。它支持CSS样式、JavaScript脚本以及字体文件的引入，能够完美地保留原始网页的布局和样式。

安装

Windows系统

在Windows系统上安装wkhtmltopdf非常简单。你只需要从官方网站上下载对应的Windows安装包，然后按照提示进行安装即可。

Linux系统

在Linux系统上安装wkhtmltopdf需要通过命令行来完成。以下是常用的几个Linux发行版的安装命令：

Debian/Ubuntu:

sudo apt-get install wkhtmltopdf

CentOS/Fedora:

sudo yum install wkhtmltopdf

Arch Linux:

sudo pacman -S wkhtmltopdf

如果你使用的是其他Linux发行版，请参考相应的包管理工具进行安装。

macOS系统

在macOS系统上安装wkhtmltopdf可以使用Homebrew包管理器。首先，你需要安装Homebrew。打开终端并执行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

安装完成后，你可以使用以下命令安装wkhtmltopdf：

brew install Caskroom/cask/wkhtmltopdf

基本用法

使用wkhtmltopdf非常简单，你只需要通过命令行调用它，并指定要转换的HTML文件或网址以及输出的PDF文件路径即可。

以下是基本用法的示例：

wkhtmltopdf input.html output.pdf

input.html是要转换的HTML文件或网址，可以是本地文件路径或远程网址。
output.pdf是要生成的PDF文件路径。

除了基本用法外，wkhtmltopdf还提供了许多自定义选项，可以进一步控制转换的行为和效果。下面我们来介绍一些常用的选项。

自定义选项

页面大小

你可以使用--page-size选项指定PDF文件的页面大小。wkhtmltopdf支持多种预定义的页面大小，如A4、Letter等。以下是示例代码：

wkhtmltopdf --page-size A4 input.html output.pdf

在这个示例中，我们将PDF文件的页面大小设置为A4，然后将input.html转换为output.pdf。

边距

你可以使用--margin-top、--margin-right、--margin-bottom和--margin-left选项来设置PDF文件的上、右、下、左边距。以下是示例代码：

wkhtmltopdf --margin-top 10mm --margin-right 15mm --margin-bottom 20mm --margin-left 25mm input.html output.pdf

在这个示例中，我们将PDF文件的上边距设置为10mm，右边距设置为15mm，下边距设置为20mm，左边距设置为25mm，然后将input.html转换为output.pdf。

头部和尾部

你可以使用--header-html和--footer-html选项来添加自定义的头部和尾部。可以通过提供一个HTML文件或网址来定义这些内容。以下是示例代码：

wkhtmltopdf --header-html header.html --footer-html footer.html input.html output.pdf

在这个示例中，我们分别使用header.html和footer.html作为PDF文件的头部和尾部，然后将input.html转换为output.pdf。

示例代码

下面是一个完整的示例代码，演示了如何使用wkhtmltopdf将一个简单的HTML页面转换为PDF文件：

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>Hello, wkhtmltopdf!</title>
  <style>
    body {
      font-family: Arial, sans-serif;
    }
    h1 {
      color: #009688;
    }
  </style>
</head>
<body>
  <h1>Hello, wkhtmltopdf!</h1>
  <p>This is a test PDF generated by wkhtmltopdf.</p>
</body>
</html>

保存为input.html文件后，你可以使用以下命令将其转换为PDF文件：