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

时间:2013-06-06 12:37:10

标签: makefile python-sphinx restructuredtext

我使用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或命令行调用中是否存在问题?

(另外,如果可能,我还想指定多个代码,例如draftadmin。)

1 个答案:

答案 0 :(得分:5)

您需要稍微修改一下命令(变量赋值必须在make之后)。这些都适用于我(使用GNU make):

make SPHINXOPTS="-t draft" latexpdf    

make latexpdf SPHINXOPTS="-t draft"