<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Aug 26, 2015 at 9:31 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 2015-08-25 00:12, Lana Brindley wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
-----BEGIN PGP SIGNED MESSAGE-----<br>
Hash: SHA1<br>
<br>
On 25/08/15 04:41, Andreas Jaeger wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
If you look at the sidebar for the Install Guide, for example at<br>
<a href="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" rel="noreferrer" target="_blank">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</a><br>
<br>
<br>
<br>
you'll see that the TOC is duplicated. This is our old friend using<br>
only together with toctree. This does not work due to the way that<br>
Sphinx parses.<br>
<br>
I have a workaround in change:<br>
<br>
<a href="https://review.openstack.org/216364" rel="noreferrer" target="_blank">https://review.openstack.org/216364</a><br>
<br>
This leads now to a proper sidetable for all builds besides Debian<br>
- for Debian there's no sidetable anymore.<br>
<br>
An alternative might be some usage of sed add the chapter.<br>
<br>
I'm not sure yet how all of this works with translation where we<br>
basically build one document with all contents to send all strings<br>
to our translation server.<br>
<br>
I won't be able to fix this myself in the near future, so ask that<br>
somebody looks into this. Either take my change, enhance it - or<br>
do something completely different...<br>
</blockquote>
<br>
Thanks for the workaround, Andreas. Do we have any takers on getting<br>
this sorted out properly?<br>
</blockquote>
<br></span></blockquote><div><br></div><div>I honestly believe Andreas's solution is the best way forward until someone enhances upstream Sphinx.</div><div><br></div><div>As an alternative we could enforce a common TOC for Debian to follow but that's resurrecting a very old, tired conversation. :)</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
<br></span>
I hope this is working now with my most recent changes but somebody needs to test that all strings are in our pot files,</blockquote><div><br></div><div>Can you send an email to the i18N team mailing list so they have a heads-up?</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="im HOEnZb"><br>
<br>
Andreas<br>
-- <br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
<br>
<br></span><div class="HOEnZb"><div class="h5">
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Anne Gentle</div><div>Rackspace</div><div>Principal Engineer</div><div><a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div></div></div>
</div></div>