Open Stack

On Wed, Aug 26, 2015 at 9:31 AM, Andreas Jaeger <aj at suse.com> wrote:

> 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 honestly believe Andreas's solution is the best way forward until someone
enhances upstream Sphinx.

As an alternative we could enforce a common TOC for Debian to follow but
that's resurrecting a very old, tired conversation. :)


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


Can you send an email to the i18N team mailing list so they have a heads-up?

Anne


>
>
> 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
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>



-- 
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150826/6443369a/attachment.html>