makefile - 在使用 Makefile 调用 Sphinx 时，如何使用 SPHINXOPTS 触发 "only"指令？

Question

我正在使用 autogenerated Makefile 通过 Sphinx 生成 PDF .我通常使用以下方法生成它:

make latexpdf

但是，我现在包括 only指令，所以 some sections appear conditionally (如果我在命令行中包含相关标记，就会发生这种情况)。

我将以下 reST 标记添加到我的源文件中:

Hello world

.. only:: draft

          This is some draft content.

我尝试按如下方式生成 PDF:

SPHINXOPTS="-t draft" make latexpdf

...但输出结果与我正常运行 make latexpdf 相同，“唯一”部分不会出现。我的 reST 或我的命令行调用有问题吗？

(此外，如果可能，我想指定多个标签，例如 draft 和 admin。)

Answer 1

你需要稍微修改命令(变量赋值必须在make之后)。这些都对我有用(使用 GNU make):

make SPHINXOPTS="-t draft" latexpdf    

或

make latexpdf SPHINXOPTS="-t draft"