rCore-Tutorial-Book-v3/setup-sphinx

[utterances-bot]

修改和构建本项目 — rCore-Tutorial-Book-v3 0.1 文档

https://rcore-os.github.io/rCore-Tutorial-Book-v3/setup-sphinx.html

[hg2008]

该文档的项目和源代码项目不是同一个，文档项目可以通过 git clone git://github.com/rcore-os/rCore-Tutorial-Book-v3.git得到，然后执行上面的第6步，因为我是windows环境，所以，命令要分两次，一次是make.bat clean，然后是make.bat html，即可生成本地文档，方便多了！

[MountainColdWay]

文档生成上可能有一丝丝的问题，有几个图片是gif，导致无法生成pdf

[dockcy]

文档生成上可能有一丝丝的问题，有几个图片是gif，导致无法生成pdf

@MountainColdWay 想请教下生成PDF的方法

[longguzzz]

发现了Sphinx用来生成pdf的一种方法：（首先不要搞latex，然后尝试）通过make命令生成epub文件，再转pdf

[jiangshengdev]

source/conf.py 文件支持配置字体等样式，设置后可生成符合自身喜好的PDF文件

#...
# -- General configuration ---------------------------------------------------

latex_elements = {
    'fontpkg': r'''
\setmainfont{SF Pro}
\setsansfont{SF Pro}
\setmonofont{SF Mono}
\setCJKmainfont{PingFang SC}
\setCJKsansfont{PingFang SC}
\setCJKmonofont{PingFang SC}
''',
    'preamble': r'''
\linespread{1.2}
\usepackage{indentfirst}
\setlength{\parindent}{2em}
''',
}

# Add any Sphinx extension module names here, as strings. They can be
# ...

https://www.aliyundrive.com/s/C9DtRWtjXRs 使用上述配置生成的示例文件（2023-04-08版本），采用了无衬线体

参考文档： https://www.sphinx-doc.org/en/master/latex.html

[wyfcyx]

非常感谢 @jiangshengdev 同学帮忙踩坑！后面我们会尝试更新latex相关配置看看。