使用latexpdf的Sphinx PDF输出

Question

我正在尝试将Sphinx doc输出构建为PDF而不是HTML.我只能使用Sphinx附带的工具,即我无法下载rst2pdf等附加工具.我已经尝试使用'make latexpdf',根据Sphinx文档,它说明除了.tex文件之外它还会生成pdf.但是我只得到.tex.我错过了什么？Sphinx文档声明将生成PDF文件.

Answer 1

Sphinx使用Latex将文档导出为PDF文件.
因此,需要用于在系统上编写pdf的基本Latex依赖项.

例如,在运行Ubuntu 16.04的系统上,可以通过以下方式下载和安装它们:

apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended

_{如果在GNU/Linux或OSX上运行Sphinx 1.6或更高版本,您可能还需要该latexmk软件包.
参考:sphinx.builders.latex.LaTeXBuilder文档.}

安装上述软件包后,make latexpdf在sphinx项目目录中运行会 生成文档输出作为PDF文件./_build/latex/<sphinx-project-name>.pdf>

_{注意:在当前运行后未在系统上看到PDF文件的情况下make latexpdf,请检查命令的输出是否有关于缺少乳胶工具/文件的任何错误.使用系统软件包管理器识别缺少的软件包并进行安装.}