makefile - 使用 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正常运行时相同，“唯一”部分不会出现。我的 reST 或命令行调用有问题吗？

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

score 6 · Accepted Answer

您需要稍微修改命令（变量赋值必须在之后make）。这些都对我有用（使用 GNU make）：

make SPHINXOPTS="-t draft" latexpdf

或者

make latexpdf SPHINXOPTS="-t draft"

1 回答 1