sphinx相关的文档:​http://zh-sphinx-doc.readthedocs.org/en/latest/contents.html


1、安装texlive

如果在编译reStructure的文档时提示您:xelatex: command not find,那么就需要安装texlive。

texlive是Latex的一个发行版本,里面继承了很多Latex常用的工具,其中默认的就有中文的解决方案。这里我们需要使用的是里面的xelatex命令工具,xecjk工具包。

安装:sudo apt-get install texlive-full

安装完整的texlive,虽然比较大,安装完大概占1.4G左右,但是比较保险。理论上我们只要以下内容,但是未经测试不知是否成功:

sudo apt-get install texlive-xetex latex-cjk-all


2、安装wqy-microhei字体

我在编译reStructure文档的时候,提示:"WenQuanYi Micro Hei" can't be found。那么需要安装wqy-microhei字体。

1)到文泉驿官网下载字体:​​http://wenq.org/wqy2/index.cgi?MicroHei​

sphinx相关_官网


2)按照wqy-microhei/INSTALL.txt说明安装文件。基本就是如下:

tar zxvf wqy-microhei*.tar.gz

change to root user, move the extracted folder, "wqy-microhei" under /usr/share/fonts/wenquanyi/ (If this dir does not exist, create it first.)

Edit /etc/fonts/fonts.conf, append <dir>/usr/share/fonts/wenquanyi/wqy-microhei/</dir> before </fontconfig>

ok!