7.5. Sphinx 生成 PDF

Sphinx 生成 PDF 可以通过多种方式。 比较方便的是使用中间结果进行转换。 但是直接通过编译命令生成可能更符合程序员或者技术人员的价值观。

7.5.1. 编译生成 PDF

Sphinx 编译生成 PDF 的结果需要配合使用 Latex 运行环境。 在中间关键是 Latex 运行环境的搭建； 在使用上需要用到一点 Latex 的知识，主要是配置的问题。 这两方面对于熟悉 Latex 的用户问题不大； 但对于只了解 Sphinx 而又希望能得到较好 PDF 输出的用户确实会感觉比较麻烦。

命令行生成有两种方式。

第一种是切换到项目主目录下，运行

make latex

将命令行目录切换到 build/latex/ 下，再运行

make

第二种是直接运行如下命令：

make pdflatex

这二者的区别在于第一种分了两步，在两步只间可能通过各种方式优化或者说调整 Latex 文件， 从而得到更好的结果。

7.5.2. Debian/Ubuntu 操作系统下的使用

待完成。

7.5.3. Windows 环境下的使用

有必要在这里先写上个人心得：环境搭建太麻烦，结果输出不够理想！

latex 环境安装

在 Windows 下需要安装 latex 环境

安装 Miktex 软件，软件文件名为 basic-miktex-21.12-x64.exe

Miktex 需要 perl 环境，所以还要安装 perl 环境。

perl 环境安装 strawberryperl

软件名：strawberry-perl-5.32.1.1-64bit.msi

验证安装成功：在命令行界面输入 perl –version

首次运行需要安装很多插件，将显示弹出窗口的勾去掉，就会自动安装到完。下次运行相对就快了。

生成的文件在当前目录下，总体来说挺不错，生成的目录我个人相当喜欢。 不过字体太小了，目前不知道怎么调，不够理想！ 个人还是不太喜欢通过这种方式生成的 pdf，总体来说不太理想！ 并且环境搭建过程实在是太麻烦了！