[OpenStack-docs] Problem with Debian install Guide Toc - need help

Andreas Jaeger aj at suse.com
Mon Aug 24 18:41:53 UTC 2015


If you look at the sidebar for the Install Guide, for example at
http://docs-draft.openstack.org/33/216033/4/check/gate-openstack-manuals-tox-doc-publish-checkbuild/78442d3//publish-docs/draft/install-guide-obs/index.html

you'll see that the TOC is duplicated. This is our old friend using only 
together with toctree. This does not work due to the way that Sphinx parses.

I have a workaround in change:

https://review.openstack.org/216364

This leads now to a proper sidetable for all builds besides Debian - for 
Debian there's no sidetable anymore.

An alternative might be some usage of sed add the chapter.

I'm not sure yet how all of this works with translation where we 
basically build one document with all contents to send all strings to 
our translation server.

I won't be able to fix this myself in the near future, so ask that 
somebody looks into this. Either take my change, enhance it - or do 
something completely different...

Thanks,
Andreas
-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Graham Norton,
        HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126




More information about the OpenStack-docs mailing list