在使用Makefile调用Sphinx时如何使用SPHINXOPTS触发“ only”指令？

Question

我正在使用自动生成的Makefile通过Sphinx生成PDF 。我通常使用以下命令生成它：

make latexpdf

但是，我现在包括唯一的指令，以便某些部分有条件地显示（如果我在命令行中包含相关标签，则应该发生这种情况）。

我在源文件中添加了以下reST标记：

Hello world

.. only:: draft

          This is some draft content.

我尝试生成PDF，如下所示：

SPHINXOPTS="-t draft" make latexpdf

...但是输出与我将make latexpdf正常运行时的输出相同，因此不会显示“ only”部分。我的reST或命令行调用是否存在问题？

（此外，如果可能的话，我想指定多个标签，例如draft和admin。）

Answer 1

您需要稍微修改一下命令（变量赋值必须在后面make）。这些对我来说都是有效的（使用GNU make）：

make SPHINXOPTS="-t draft" latexpdf    

要么

make latexpdf SPHINXOPTS="-t draft"