wkhtmltopdf 实践

wkhtmltopdf 简介：

wkhtmltopdf 是一个使用 Qt WebKit 引擎做渲染,能够把 html 文档转换成 pdf 文档或图片的命令行工具。支持多个平台，包括 windows、linux、os x 等系统。

优点：

1.小巧方便、转换速度快。

2.跨平台。

使用方式：命令

格式：wkhtmltopdf [GLOBAL OPTION]... [OBJECT]... <output file>

例子：

html 文件转换成 pdf：wkhtmltopdf index.html index.pdf

url 指向的网页转换为 pdf: wkhtmltopdf www.infoq.cn infoq.pdf

html 文件转换成图片：wkhtmltoimage index.html index.jpg

url 指向的网页转换为图片：wkhtmltoimage www.infoq.cn index.jpg

主要参数：

 --allow <path>  允许加载从指定的文件夹中的文件或文件（可重复）

  --copies <number>  复印打印成 pdf 文件数（默认为 1）

  --cover* <url>  使用 HTML 文件作为封面。它会带页眉和页脚的 TOC 之前插入 

  --encoding <encoding>  设置默认的文字编码 

--margin-bottom <unitreal>  设置页面下边距 (default 10mm) 

--margin-left <unitreal>  将左边页边距 (default 10mm) 

--margin-right <unitreal>  设置页面右边距 (default 10mm) 

--margin-top <unitreal>  设置页面上边距 (default 10mm) 

 --minimum-font-size <int>  最小字体大小 (default 5) 

遇到的坑：

在线上系统出现乱码方框的情况，线上系统是 CentOS 6.5。

原因和处理方式：

1、原因：主要是缺少中文字体。

2、处理方法：

a.windows 系统 C:\Windows\Fonts 下获取 simsun.ttc（宋体）

b.复制到 centos 下的/usr/share/fonts

c、重新生成