HTML转PDF

2017-12-09

经常会遇到一些转换需求，如HTML转PDF，我一般都会用pdfkit这个库，分享一下使用过程。

安装依赖

wkhtmltopdf

pdfkit只是提供了访问的API，具体实现还需要在你的机器上安装 wkhtmltopdf，在安装wkhtmltopdf前还需要安装它所依赖的字体

1
2
3

yum install -y xorg-x11-fonts-75dpi

yum install -y xorg-x11-fonts-Type1

然后根据自己的版本需求，下载它对应的安装包

1	wget http://download.gna.org/wkhtmltopdf/0.12/0.12.2.1/wkhtmltox-0.12.2.1_linux-centos7-amd64.rpm

安装

1	rpm -Uvh wkhtmltox-0.12.2.1_linux-centos7-amd64.rpm

测试

1	wkhtmltopdf https://uxiu.info uxiu.pdf

若无错误，会看到打印

Loading pages (1/6)
Counting pages (2/6) 
Resolving links (4/6) 
Loading headers and footers (5/6) 
Printing pages (6/6)
Done

pdfkit

用pip安装

1	pip install pdfkit

开始使用

我是在django项目中有的这个需求，所用模板渲染我直接用了django自带的

import pdfkit
from django.template import Context
from django.template.loader import render_to_string

def render_html2pdf_stream_pdfkit(template_src, context_dict, dpi=390):
    """
        把html渲染成pdf文件stream
    :param template_src: html文件路径
    :param context_dict: 数据渲染所需参数
    :param dpi: wkhtmltopdf的dpi选项
    :return: 文件stream if success otherwise None
    """

    options = {
        "quiet": "", # 不打印wkhtmltopdf运行信息
        "page-size": "A4",
        "encoding": "UTF-8",
        "no-outline": None,
        "dpi": dpi,
    }
    context = Context(context_dict)
    # 渲染html
    html = render_to_string(template_src, context).encode("UTF-8")
    # output_path=False表示不生成本地文件
    return pdfkit.from_string(input=html, output_path=False, options=options)

当然，你也可以像上面的测试一样，直接把URL的内容生成PDF

import pdfkit

# output_path=False表示不生成本地文件
stream = pdfkit.from_url(url=temp_url, output_path=False, options=options)

# 或者
pdfkit.from_url(url=temp_url, output_path='./demo.pdf', options=options)

如果发现PDF文件的效果和HTML的效果大相庭径，很可能是你的options参数的问题(如dpi)，关于wkhtmltopdf的参数，可参考 options