How do I use SPHINXOPTS to trigger the "only" directive when invoking Sphinx with a Makefile?

Question

I am generating a PDF via Sphinx using the autogenerated Makefile. I usually generate it using:

make latexpdf

However, I am now including the only directive, so that some sections appear conditionally (this should happen if I include the relevant tag at the command line).

I added the following reST markup to my source file:

Hello world

.. only:: draft

          This is some draft content.

I tried generating the PDF as follows:

SPHINXOPTS="-t draft" make latexpdf

...but the output is the same as if I'd just run make latexpdf as normal, the "only" section does not appear. Is there a problem in my reST or my command line invocation?

(Also, I'd like to specify multiple tags if possible, e.g. draft and admin.)

Does it work if you run `make latexpdf SPHINXOPTS="-t draft"`? — mzjn, Jun 11 '13 at 15:57
@mzjn doh and thanks - do you want to make that an answer? :) — lofidevops, Jun 12 '13 at 11:54

score 6 · Accepted Answer · answered Jun 12 '13 at 12:21

6

You need to modify the command a little (the variable assignment must come after make). Either of these work for me (using GNU make):

make SPHINXOPTS="-t draft" latexpdf

or

make latexpdf SPHINXOPTS="-t draft"

answered Jun 12 '13 at 12:21

mzjn

48,958
13
128
248

How do I use SPHINXOPTS to trigger the "only" directive when invoking Sphinx with a Makefile?

1 Answers1

Linked