sphinx PDF 中文

使用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的事了，我无能为力了！