BookStack 文章 PDF 导出及解决中文乱码问题

BookStack PDF导出，有两个选择，默认情况下使用 dompdf ，但也可以安装 wkhtmltopdf 来追求更完美的效果。

PDF渲染

默认情况下，BookStack使用dompdf将页面导出为PDF文档。使用dompdf的好处是，它不需要任何额外的安装或设置，但渲染功能有些有限。
作为替代方案，您可以使用wkhtmltopdf生成PDF文档。wkhtmltopdf使用qt webkit呈现引擎提供更准确的整体结果。

使用wkhtmltopdf

wkhtmltopdf的预编译二进制文件可以在其网站的下载页面上找到。bookstack将在bookstack安装的基本文件夹中检查名为wkhtmltopdf的文件。如果找到，它将使用它来呈现PDF。如果不存在，它将检查.env文件中的wkhtmltopdf变量。可以使用此变量将备用位置设置为wkhtmltopdf:

配置 .env 使wkhtmltopdf 生效

vi .env
wkhtmltopdf=/user/local/bin/wkhtmltopdf

更新BookStack配置缓存

php artisan cache:clear
php artisan view:clear
php artisan config:cache

下面以FreeBSD为例，安装 wkhtmltopdf 和 中文 字体

cd /usr/ports/converters/wkhtmltopdf && make install clean
cd /usr/ports/x11-fonts/wqy && make install clean
cd /usr/ports/print/adobe-cmaps  && make install clean

刷新字体生效

fc-cache -f -v

因为系统没有安装对中文字体的支持，所以导出的PDF会如下图产生乱码

安装完字体，刷新生效后再次导出，中文方块乱码问题就解决了