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

Andreas Jaeger aj at suse.com
Wed Aug 26 14:31:59 UTC 2015


On 2015-08-25 00:12, Lana Brindley wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> On 25/08/15 04:41, Andreas Jaeger wrote:
>> 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 for the workaround, Andreas. Do we have any takers on getting
> this sorted out properly?


I hope this is working now with my most recent changes but somebody 
needs to test that all strings are in our pot files,

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