sphinx-doc生成中文pdf

参考链接：
1.https://sphinx-note.readthedocs.io/zh-cn/latest/tutorial/pdf.html
2.https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language

环境准备

博主环境：Ubuntu22.04的Docker环境内。

将ubuntu源替换成清华源：

https://mirrors.tuna.tsinghua.edu.cn/help/ubuntu/

一、配置过程

安装tex环境：

sudo apt -y  install latexmk texlive-xetex

安装相关包：

sudo apt -y install latex-cjk-all texlive-full

安装字体：

sudo apt -y install fonts-freefont-otf

在conf.py中设置latex_elements参数, 同时也可以设置latex_documents参数设置文档。样例见下：(博主调过了此步骤，没有配置)

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

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

    # Additional stuff for the LaTeX preamble.
    #
    'preamble': '',

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

编译：

make latexpdf

常见问题

常规按照上文，可一次通过。但有一次，我把conf.py里面的语言换成了en，才编译通过。