如何在Windows中使用Sphinx创建PDF文档

Question

我正在使用Sphinx为我在Windows中的Python项目创建文档。我需要生成PDF文档。我在Linux中找到了很多解释如何做到这一点，但没有很好的解释如何在Windows中执行此操作。据我所知，我需要使用Sphinx创建Latex格式，而不是使用Texworks将Latex转换为PDF。假设我创建了Latex格式的文档并安装了Texworks，那么有人可以一步一步解释我该怎么做？

Answer 1

安装MiKTeX（<200mb）

wget -nv -N http://mirrors.ctan.org/systems/win32/miktex/setup/miktex-portable-2.9.4757.exe
7z.exe x -y miktex-portable-2.9.4757.exe -o"miktex"

将bin目录添加到路径中

SET Path=%Path%;%CD%\miktex\miktex\bin

运行Sphinx的“make.bat”来生成.tex文件。

SET SPHINXOPTS=-W -E
make.bat latex

调用MiKTeX的pdflatex：

cd build/latex
pdflatex.exe YOUR_PROJECT_NAME.tex

生成的PDF将位于build / latex目录中

Answer 2

安装完整的tex live发行版，它将安装latex，PDF后端和texworks。是的，很多，是的，根据您的管道，它将安装一个小时。但它总是次要的，现在硬盘很大。

从我看来，Texworks只是一个简单的LaTeX编辑器，具有一些构建功能和乳胶语法高亮。只是编译它不是真的需要（你可以使用记事本）

然后它应该是简单地把tex实时二进制目录i路径和做

    pdflatex <yourlatexdocument.tex>

在cmdline上，至少这是我用自己的文档生成工具的乳胶输出做的

Answer 3

正如您已经想到的那样：使用Sphinx生成LaTeX源代码，然后通过LaTex编译器运行它来生成PDF。

我建议您使用其中一个在线LaTeX服务，而不是因为安装LaTeX（这可能令人生畏）并设置编辑器而烦恼。然后，您只需要在ShareLaTeX或Overleaf中创建项目（正在合并的过程中），上传Sphinx build \ latex目录的内容，在线编译，并下载完成的PDF。

这种方法运行得相当不错，但由于输出目标非常不同（HTML与正式文档相比），您可能不得不使用reST来按照自己喜欢的方式进行操作。