sphinx PDF 中文

Posted 2020-10-20 WindTaiL的博客

使用reST撰写文档时，需要分多个文档时，就必须使用sphinx了，sphinx说起来很简单的，但是默认是不是支持中文的。幸好我出生的晚，sphinx现在已经支持xelatex了^_^

安装

除了pandoc那篇文章里写到的要安装的东西，还需要安装如下软件包

sudo apt install latexmk texlive-lang-chinese

 

操作

sphinx-quickstart docs

以上命令会在当前目录的 docs 子目录中创建一大堆文件（如果不指定docs，则在当前文件夹内创建）。如果是英文的话，我们只要执行

make latexpdf

PDF文档就生成了，但是中文需要修改下配置，研究了半天，最简单的方式是

latex_engine = \'xelatex\'
latex_elements = {
    # The paper size (\'letterpaper\' or \'a4paper\').
    #
    # \'papersize\': \'letterpaper\',

    # The font size (\'10pt\', \'11pt\' or \'12pt\').
    #
    # \'pointsize\': \'10pt\',

    \'fncychap\' : \'\',

    # Additional stuff for the LaTeX preamble.
    #
    \'preamble\': r\'\'\'\\usepackage{ctex}
    \'\'\',

    # Latex figure (float) alignment
    #
    # \'figure_align\': \'htbp\',
}

本来也想用xeCJK，不过搞起来有点困难（虽然也能生成PDF），这里只是引用入ctex宏包，然后把fncychap宏包给去掉了，因为它不支持中文，如果加上章节标题就会是“Chapter 1”这种，而不是“第一章”，当然，去掉之后，标题就不那么fancy了，不过那都是latex的事了，我无能为力了！