html-pdf 在 CentOS 上的问题

本周的早些时候，在最近的项目中写了一个 Feature，大概的功能是获取一个产品的详情、渲染成 HTML、然后用 html-pdf 生成为 PDF 下载。

这是一个比较简单的功能，但是在今天测试的时候发现了问题：通过测试服务器下载文件「乱码」-- 文字显示都变成了一个个方块，只有数字显示正常，大概长这样：

乱码？

测试服务器是 CentOS，而我之前也没有遇到过这样的问题，因此「乱码」是率先进入我脑海的词汇。

于是乎，我在现有的代码上纠结了很久，主要尝试了下面两种方法：

1. 声明了 Content-type 中的 charset:

res.set('Content-type', 'application/pdf; charset=utf-8');

2.在使用 html-pdf 生成的 Buffer 声明编码：

res.end(buffer, 'utf-8');

当然这两者都于事无补。

此后，搜索的关键词也从"response", "charset", "encoding"，"html-pdf"的排列组合变成了 "CentOS", "html-pdf", "font"。

皇天不负有心人，总算在 Github 上找到了一个相关的 issue: CentOS text does not render :

Solved by install system fonts.

循着这条线索，很快在 StackOverFlow 上找到了解决问题的问题，解决方法如下：

yum install cjkuni-ukai-fonts

这样，生成的 PDF 文件就不再「乱码」了。

当然，也可以安装更完整的中文字体支持，如下：

yum groupinstall "chinese support"

---

"html-pdf"模块使用的 PhantomJS 模拟 Webkit 访问之前模板生成 HTML 然后用 "Screen Capture" 的方式生成 PDF 文件:

Since PhantomJS is using WebKit, a real layout and rendering engine, it can capture a web page as a screenshot. Because PhantomJS can render anything on the web page, it can be used to convert contents not only in HTML and CSS, but also SVG and Canvas.