Open Stack

On 2015-08-26 16:39, Anne Gentle wrote:
>
>
> On Wed, Aug 26, 2015 at 9:31 AM, Andreas Jaeger <aj at suse.com
> <mailto: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?

I just checked, it should be fine - but we really need to keep the 
content the same in both index files because index-debian is the one 
that gets translated...

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