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

时间:2012-10-31 10:07:50

标签: windows pdf python-sphinx

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

3 个答案:

答案 0 :(得分:14)

安装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目录

答案 1 :(得分:5)

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

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

那么它应该是简单地将tex live binary目录放在路径上并执行

    pdflatex <yourlatexdocument.tex>
cmdline上的

,至少这是我对自己的文档生成工具的乳胶输出的处理

答案 2 :(得分:-1)

您已经发现:使用Sphinx生成LaTeX源,然后通过LaTex编译器运行它以生成PDF。

我建议您使用一种在线LaTeX服务,而不是麻烦您安装LaTeX(这可能令人生畏)并设置编辑器。然后,您只需要在ShareLaTeX或Overleaf中创建一个项目(例如,正在合并中),上传Sphinx build \ latex目录的内容,进行在线编译,然后下载完成的PDF。

这工作得相当好,但是由于输出目标非常不同(HTML与正式文档),因此您可能必须摆弄reST才能以自己喜欢的方式进行操作。

相关问题