[OpenStack-docs] OpenStack-docs Digest, Vol 37, Issue 45

Christian Berendt christian at berendt.io
Mon Jul 27 18:43:52 UTC 2015


On 07/27/2015 04:01 PM, Karen Bradshaw wrote:
> Try to *not* use auto numbering with .. only:: directives.

Hmm. How to solve the following case without duplicating the content? (I 
have a similiar case for the Swift section.)

#.

.. only:: rdo

    2. foo

.. only:: rdo or ubuntu

    3. bar

       more content...

4. blar

    a lot of more content

5. blub

    and mor content

Not being able to use auto numbering we have to duplicate the whole 
content of the content inside .. only:: rdo or ubuntu because the 
numbering for rdo is 1., 2., 3., 4., 5. and for ubuntu it is 1., 2., 3., 
4. So we also have to duplicate all the content after the second usage 
of the only directive (4. in this simple example).

Is there a pending bug report for Sphinx to fix the auto numbering 
feature when using the only feature? I really do not like to manually 
number lists. This will result in a lot of overhead (renumbering when 
adding a new entry to a list, ..), unmaintable documents, and wrong 
numbered lists.

Christian.



More information about the OpenStack-docs mailing list