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