pdf - 使用Latexpdf输出Sphinx PDF

Question

我正在尝试将Sphinx doc输出构建为PDF而不是HTML。我只能使用Sphinx随附的工具，即无法下载rst2pdf之类的其他工具。我已经尝试过使用Sphinx文档中的“make latexpdf”，它指出除了.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

_{If running Sphinx 1.6 or above on GNU/Linux or OSX, you may also need the latexmk package.
Reference: sphinx.builders.latex.LaTeXBuilder documentation.}

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

注意:在当前情况下，运行 make latexpdf后在系统上看不到PDF文件，请检查命令输出中是否有关于缺少 latex 工具/文件的错误。使用系统软件包管理器来识别丢失的软件包并进行安装。