说起pdf就想到了一款很适用的工具，那就是pdfkit，在前几天的项目中，有一个功能要实现，为了实现这一个功能，于是我大海茫茫中查询各种百科，不负众望的让我找到了我心怡的工具，想必也就是它了。好了废话也不多说了，开始进入高潮部分吧~~~
1、说明
pdfkit，把HTML·+ CSS格式的文件转换成PDF格式文档的一种工具。
其实，它就是html转换成PDF工具包wkhtmltopdf的Python封装，所以，必须安装wkhtmktopdf。一般情况下，wkhtmkltopdf需要手动安装，尤其要注意的是Windows下，需要把wkhtmltopdf的bin执行文件路径添加到PATH变量中。
2、安装
请参考《Python抓取网页并保存为PDF》里面各个安装包的安装
3、API说明
def from_url(url, output_path, options=None, toc=None, cover=None, configuration=None, cover_first=False): """ 把从URL获取文件转换为PDF文件 :param url:URL 或 URL列表 :参数，output_path: 输出PDF文件的路径。如果是参数等于False，意味着文件将会以字符串的形式返回，得到文本文件。:param options: (可选) dict with wkhtmltopdf global and page options, with or w/o '--' :param toc: (可选) dict with toc-specific wkhtmltopdf options, with or w/o '--' :param cover: (可选) string with url/filename with a cover html page :param configuration: (可选)实例化 pdfkit.configuration.Configuration() :param configuration_first: (optional) if True, cover always precedes TOC 返回值：成功返回True """ r = PDFKit(url, 'url', options=options, toc=toc, cover=cover,configuration=configuration, cover_first=cover_first) return r.to_pdf(output_path)
def from_file(input, output_path, options=None, toc=None, cover=None, css=None, configuration=None, cover_first=False): """ Convert HTML file or files to PDF document :param input: path to HTML file or list with paths or file-like object :param output_path: path to output PDF file. False means file will be returned as string. :param options: (optional) dict with wkhtmltopdf options, with or w/o '--':param toc: (optional) dict with toc-specific wkhtmltopdf options, with or w/o '--' :param cover: (optional) string with url/filename with a cover html page :param css: (optional) string with path to css file which will be added to a single input file :param configuration: (optional) instance of pdfkit.configuration.Configuration() :param configuration_first: (optional) if True, cover always precedes TOC Returns: True on success """ r = PDFKit(input, 'file', options=options, toc=toc, cover=cover, css=css, configuration=configuration, cover_first=cover_first) return r.to_pdf(output_path)
def from_string(input, output_path, options=None, toc=None, cover=None, css=None, configuration=None, cover_first=False):"""Convert given string or strings to PDF document:param input: string with a desired text. Could be a raw text or a html file:param output_path: path to output PDF file. False means file will be returned as string.:param options: (optional) dict with wkhtmltopdf options, with or w/o '--':param toc: (optional) dict with toc-specific wkhtmltopdf options, with or w/o '--':param cover: (optional) string with url/filename with a cover html page:param css: (optional) string with path to css file which will be added to a input string:param configuration: (optional) instance of pdfkit.configuration.Configuration():param configuration_first: (optional) if True, cover always precedes TOCReturns: True on success"""r = PDFKit(input, 'string', options=options, toc=toc, cover=cover, css=css, configuration=configuration, cover_first=cover_first)return r.to_pdf(output_path)
4、举例说明
4.1 简单的例子
import pdfkit pdfkit.from_url('https://www.google.com.hk','out1.pdf')
pdfkit.from_file('123.html','out2.pdf')
pdfkit.from_string('Hello!','out3.pdf')
也可以传递一个url或者文件名列表：
pdfkit.from_url(['https://www.google.com.hk','https://baidu.com','http://cn.bing.com/'],'out_0.pdf')
pdfkit.from_file(['122.html','123.html'],'out_1.pdf')
如何你想对生成的PDF作进一步处理，你可以将其读取到一个变量中:
pdf=pdfkit.from_url('https://www.google.com.hk',False)
你可以指定所有的 wkhtmltopdf选项 。你可以移除选项名字前面的 ‘–’ .如果选项没有值, 使用None, False或者“*”作为字典值:
在views视图中可以加上options进行页面布局调试
options = {'page-size':'Letter','margin-top':'0.75in','margin-right':'0.75in','margin-bottom':'0.75in','margin-left':'0.75in','encoding':"UTF-8",'no-outline':None
}
pdfkit.from_url('https://www.google.com.hk','out1.pdf',options=options)
默认情况下, PDFKit 将会显示所有的wkhtmltopdf输出. 如果你不想看到这些信息，你需要传递一个quiet选项:
options = {'quiet':''}
pdfkit.from_url('https://www.google.com.hk','out1.pdf',options=options)
由于wkhtmltopdf的命令语法 ,TOC和Cover选项必须分开指定:
toc={'xsl-style-sheet':'toc.xsl'}
cover='124.html'
pdfkit.from_file('122.html', options=options, toc=toc, cover=cover)
当你转换文件、或字符串的时候，你可以通过css选项指定扩展的 CSS 文件。
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)
配置
每个API调用都有一个可选的参数。这应该是pdfkit.configuration() API 调用的一个实例。采用configuration 选项作为初始化参数。可用的选项有:
wkhtmltopdf——wkhtmltopdf二进制文件所在的位置。默认情况下pdfkit会尝试使用which(在类UNIX系统中) 或where(在Windows系统中)来判断。
meta_tag_prefix–pdfkit的前缀指定 meta tags（元标签） - 默认情况是pdfkit-
示例 ：针对wkhtmltopdf不在系统路径中（不在$PATH里面）
config=pdfkit.configuration(wkhtmltopdf='/opt/bin/wkhtmltopdf')) pdfkit.from_string(html_string, output_file, configuration=config)
配置文件路劲是你当时下载wkhtmltopdf安装的路径，然后把它加入在里面，''out.pdf''可以更改名字，属于pdf文件名。
config = pdfkit.configuration(wkhtmltopdf='C:\\Python27\\wkhtmltopdf\bin\\wkhtmltopdf.exe')
pdfkit.from_url('http://google.com', 'out.pdf')
为了在前端一点击生成pdf下面就是显示pdf文件直接点击查看
#pdf版本导入
def html_str(html_str):import pdfkitprint "in export pdf"options = {'page-size': 'A3','margin-top': '0.75in','margin-right': '0.75in','margin-bottom': '0.75in','margin-left': '0.75in','encoding': "UTF-8",'no-outline': None}# css = {}config = pdfkit.configuration(wkhtmltopdf='D:\\pdf\\wkhtmltopdf\\bin\\wkhtmltopdf.exe')file = pdfkit.from_string(html_str, False, options=options, configuration=config)#字符串方式return file
里面还运用到了django 模板渲染功能，如果是使用字符串方式的话，可以使用这个方法，简单方便。。。。
#pdf调用方式
def export_pdf(request, pk):quotation_id = pkt = TemplateResponse(request, 'quotation.html', locals())t.render()# print t.contentfile = html_str(t.content)response = StreamingHttpResponse(file)response['Content-Type'] = 'application/octet-stream'response['Content-Disposition'] = 'attachment;filename="product.pdf"'return response ps：
win7 64位系统下，
第一步:
下载下面链接中
https://wkhtmltopdf.org/downloads.html
Windows (MinGW) 0.12.4 32-bit / 64-bit for Windows XP/2003 or later; standalone
pip install pdfkit 安装到路径：
D:\software\wkhtmltopdf
打开控制面板
系统变量Path中加入
D:\software\wkhtmltopdf\bin
与其他路径用";"隔开
)
