Hi,

I'm currently trying to implement conditional text under Sphinx 1.2.1. I 
want to exclude numbered steps related to a specific platform from an 
installation procedure.

The source file would contain:

********************

#. Step 1.

.. only:: a

   #. Step 2, meant only for platform A.

#. Step 2 or 3.

********************

I would then toggle on and of the following line in the Makefile to produce 
different output from the same source file:

SPHINXOPTS = -t a

However, this breaks list items numbering.

If I do not pass the  -t a parameter, the result is:

********************

1. Step 1.

1. Step 2, meant only for platform A.

1. Step 2 or 3.

********************

Instead of:

********************

1. Step 1.

2. Step 2, meant only for platform A.

3. Step 2 or 3.

********************

(I get this last result if I remove the only directive.)

If I do not pass the -t a parameter, the result is:

********************

1. Step 1.

1. Step 2 or 3.

********************

Instead of

********************

1. Step 1.

2. Step 2 or 3.

********************

(I get this last result if I remove the second step manually.)

The same behavior occurs if I use ifconfig.

The only workaround I've found to this issue is a quite awkward hack: 
building a text output, post-processing the output to convert it to a 
regular ReST file, then, building the final output from the post-processed 
text output.

Is this a known issue? Is there a more elegant workaround?

Thanks,

Olivier Carrère

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to