解决在readthedocs编译PDF含中文的问题

readthedocs.org编译项目的时候默认打开pdf和epub选项,中间貌似是基于LaTex的,字体问题非常头疼,之前都是在readthedocs.org项目中的高级选项选择把pdf编译禁掉,才会build pass。

最近在网上找到了解决办法:https://github.com/JuliaCN/julia_zh_cn/blob/master/conf.py

conf.py中修改latex_elements即可:

这里要注意的是,这段代码是配置LaTex,所以这些字符串必须加r,不要让pyhton解释。

所以务必检查一下几项:

  1. 不要全局导入__future__.unicode_literals,这会让这段代码编程unicode解释,readthedocs编译的时候会出字符问题。
  2. 检查项目中全局替换的部分(例如rst_epilog),如果修改到源文件,那么务必手动添加u前缀,否则会出现编码错误。

目前我只遇到这两个问题,解决之后readthedoc.org就编译通过了。不过好像编译出的pdf并不是特别美观。

Leave a comment

电子邮件地址不会被公开。 必填项已用*标注