我需要怎么做才能为Sphinx“注册”“ latexpdf”？

Question

当我使用'latexpdf'运行Sphinx时，即使我的机器上安装了完整的TeX，我也会收到错误消息：

Sphinx错误：未注册生成器名称latexpdf

我需要做什么才能“注册” latexpdf？

Answer 1

latexpdf不是Sphinx生成器；它是sphinx-quickstart创建的Makefile中目标的名称。该目标使用乳胶生成器。

执行sphinx-build -b latexpdf . _build会在问题中产生错误（如预期）。

如果您运行make latexpdf，它将起作用。

在评论中提到了PyCharm，问题似乎出在该程序上。将latexpdf配置为“命令”（Sphinx任务）时，将运行以下命令：

sphinx_runner.py -b latexpdf <indir> <outdir> 

该sphinx_runner.py脚本与sphinx_build（的包装器sphinx.cmdline.main()）非常相似。由于该-b选项应提供实际生成器的名称，因此会出现错误。

Answer 2

使用-M代替-b。这sphinx-build类似于调用make latexpdf，例如：

sphinx-build -M latexpdf . _build

有关详细信息，请参阅@mzjn 的回答。