python3.6.3中html页面转化成pdf

通常在工作中经常会遇见将某些好的html数据转换成PDF，便于存储和阅读，今天就来看看这个简单的html转换PDF模块：pdfkit

模块安装

安装python-pdfkit模块:
```
$ pip install pdfkit
```
操作系统安装wkhtmltopdf模块:

Debian/Ubuntu:
```
$ sudo apt-get install wkhtmltopdf
```

提醒：在Debian / Ubuntu版本中有减少功能（因为它编译没有wkhtmltopdf QT补丁），如添加大纲，头，页脚，toc等使用这个选项，你应该从wkhtmltopdf网站安装静态二进制文件，或者你可以使用这个脚本.

使用

简单的例子:

import pdfkit

pdfkit.from_url('http://google.com', 'out.pdf')  #获取在线的url数据进行转换生成本地out.pdf文档
pdfkit.from_file('test.html', 'out.pdf')            #获取本地html文件进行转换生成本地out.pdf文档
pdfkit.from_string('Hello!', 'out.pdf')             #将输入的文本转换生成本地out.pdf文档

可以将多个url或者文件放到一个列表中进行转换:

pdfkit.from_url(['google.com', 'yandex.ru', 'engadget.com'], 'out.pdf')
pdfkit.from_file(['file1.html', 'file2.html'], 'out.pdf')

打开文件读取数据进行转换:

with open('file.html') as f:
    pdfkit.from_file(f, 'out.pdf')

如果你想进一步生成 PDF, 你可以传递一个参数:

# 使用  False 代替输出保存一个可变的PDF
pdf = pdfkit.from_url('http://google.com', False)

你可以指定 wkhtmltopdf 选项. 在名称中你可以删除 ‘–’. 如果选择没有值, 使用None, False or “”，对于重复的选择 (允许，cookie，自定义标题，发布，postfile，运行脚本，替换) 在多个值的时候你可能会用到列表或者元组进行存储 (列入自定义头文件授权信息) 你需要两个元组存放 (看看以下例子).

options = {
    'page-size': 'Letter',
    'margin-top': '0.75in',
    'margin-right': '0.75in',
    'margin-bottom': '0.75in',
    'margin-left': '0.75in',
    'encoding': "UTF-8",
    'custom-header' : [
        ('Accept-Encoding', 'gzip')
    ]
    'cookie': [
        ('cookie-name1', 'cookie-value1'),
        ('cookie-name2', 'cookie-value2'),
    ],
    'no-outline': None
}

pdfkit.from_url('http://google.com', 'out.pdf', options=options)

默认情况, PDFKit 会显示 wkhtmltopdf 全部输出 . 如果你不想使用它,可以通过静态配置来选择:

options = {
    'quiet': ''
    }

pdfkit.from_url('google.com', 'out.pdf', options=options)

由于wkhtmltopdf命令语法，toc和cover选项必须单独指定。如果你需要覆盖之前，使用cover_first选项：

toc = {
    'xsl-style-sheet': 'toc.xsl'
}

cover = 'cover.html'

pdfkit.from_file('file.html', options=options, toc=toc, cover=cover)
pdfkit.from_file('file.html', options=options, toc=toc, cover=cover, cover_first=True)

你可以在使用css选项转换文件或字符串时指定外部css文件.

警告：这是在wkhtmltopdf这个错误的解决方法。您应该首先尝试使用-user-style-sheet选项。.

# Single CSS file
css = 'example.css'
pdfkit.from_file('file.html', options=options, css=css)

# Multiple CSS files
css = ['example.css', 'example2.css']
pdfkit.from_file('file.html', options=options, css=css)

你可以在html中元素标签中传递任何选项:

body = """
    <html>
      <head>
        <meta name="pdfkit-page-size" content="Legal"/>
        <meta name="pdfkit-orientation" content="Landscape"/>
      </head>
      Hello World!
      </html>
    """

pdfkit.from_string(body, 'out.pdf') #with --page-size=Legal and --orientation=Landscape

配置

每个api调用都需要一个可选的配置参数。这应该是pdfkit.configuration（）api调用的一个实例。它将配置选项作为初始参数。可用的选项是:

wkhtmltopdf -二进制 wkhtmltopdf 存放位置. 默认 pdfkit使用系统默认的存放位置
meta_tag_prefix -特定元标记的前缀 - 默认情况下为 pdfkit-

例子- 针对 wkhtmltopdf 不在默认 $PATH路径下的情况:

config = pdfkit.configuration(wkhtmltopdf='/opt/bin/wkhtmltopdf')
pdfkit.from_string(html_string, output_file, configuration=config)