<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">openstackdocstheme has fixed this issue already some months ago [1]. If you still see this issue on fresh docs this would hint to me that you use Sphinx>=4 but openstackdocstheme <2.3.1<div class=""><br class=""></div><div class="">[1]: <a href="https://review.opendev.org/c/openstack/openstackdocstheme/+/798897" class="">https://review.opendev.org/c/openstack/openstackdocstheme/+/798897</a><br class=""><div class=""><br class=""></div><div class="">Regards,</div><div class="">Artem<br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On 4. Nov 2021, at 16:15, Ashley Rodriguez <<a href="mailto:ashrodri@redhat.com" class="">ashrodri@redhat.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class="">Hi! <div class=""><br class=""></div><div class="">Recently I've noticed that the h1 text on the manila API ref no longer shows up in the main text body, though it is still listed in the navigation bar on the left hand side. <div class="">I've noticed a similar issue on the Ironic, Nova, Neutron API guides as well. </div><div class="">I think the change you mentioned caused this, though I'm not completely sure since not all API guides are affected. </div><div class="">For example, Swift's API guide still works as expected with visible header 1s identifying the resource, and each method being listed in the nav bar as well.</div><div class="">Cinder's API guide makes use of h2 instead, and thus doesn't have each method listed in the nav bar, though the titles are visible. </div><div class="">What I'd like to see in the manila API guide is each resource shown as h1 both in the main body and in the navigation bar, along with each corresponding method. </div><div class="">If I were to change the resource titles to h2 I would be able to see the title itself but lose the methods in the nav bar, and yet keeping them as h1 means the side bar works but the main text is missing titles. </div><div class="">I don't have much experience with front-end work so I'd really appreciate any guidance you can offer to fix this. </div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Ashley</div></div></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Aug 10, 2021 at 8:05 PM Peter Matulis <<a href="mailto:peter.matulis@canonical.com" class="">peter.matulis@canonical.com</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr" class=""><div class="">I'm now seeing this symptom on several projects in the 'latest' release branch. Such as:</div><div class=""><br class=""></div><div class=""><a href="https://docs.openstack.org/nova/latest/" target="_blank" class="">https://docs.openstack.org/nova/latest/</a><br class=""></div><div class=""><br class=""></div><div class="">My browser exposes the following error:</div><div class=""><br class=""></div><div class=""><span id="cid:ii_ks6q2laz0"><image.png></span><br class=""></div><div class=""><br class=""></div><div class="">We patched [1] our project as a workaround.</div><div class=""><br class=""></div><div class="">Could one of Stephen's commits [2] be involved?</div><div class=""><br class=""></div><div class="">[1]: <a href="https://review.opendev.org/c/openstack/charm-deployment-guide/+/803531" target="_blank" class="">https://review.opendev.org/c/openstack/charm-deployment-guide/+/803531</a><br class=""></div>[2]: <a href="https://opendev.org/openstack/openstackdocstheme/commit/08461c5311aa692088a27eb40a87965fd8515aba" target="_blank" class="">https://opendev.org/openstack/openstackdocstheme/commit/08461c5311aa692088a27eb40a87965fd8515aba</a></div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Jun 10, 2021 at 3:51 PM Peter Matulis <<a href="mailto:peter.matulis@canonical.com" target="_blank" class="">peter.matulis@canonical.com</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr" class="">Hi Stephen. Did you ever get to circle back to this?</div><br class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, May 14, 2021 at 7:34 AM Stephen Finucane <<a href="mailto:stephenfin@redhat.com" target="_blank" class="">stephenfin@redhat.com</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div class=""><div class="">On Tue, 2021-05-11 at 11:14 -0400, Peter Matulis wrote:</div><blockquote type="cite" style="margin:0px 0px 0px 0.8ex;border-left:2px solid rgb(114,159,207);padding-left:1ex" class=""><div dir="ltr" class=""><div class="">Hi, I'm hitting an oddity in one of my projects where the titles of all pages show up twice.</div><div class=""> </div><div class="">Example:</div><div class=""><br class=""></div><a href="https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/wallaby/app-nova-cells.html" target="_blank" class="">https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/wallaby/app-nova-cells.html</a><br class=""><div class=""><br class=""></div><div class="">Source file is here:</div><div class=""><br class=""></div><div class=""><a href="https://opendev.org/openstack/charm-deployment-guide/src/branch/master/deploy-guide/source/app-nova-cells.rst" target="_blank" class="">https://opendev.org/openstack/charm-deployment-guide/src/branch/master/deploy-guide/source/app-nova-cells.rst</a><br class=""></div><div class=""><br class=""></div><div class="">Does anyone see what can be causing this? It appears to happen only for the current stable release ('wallaby') and 'latest'.</div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Peter</div></div></blockquote><div class=""><br class=""></div><div class="">I suspect you're bumping into issues introduced by a new version of Sphinx or docutils (new versions of both were released recently).</div><div class=""><br class=""></div><div class="">Comparing the current nova docs [1] to what you have, I see the duplicate <h1> element is present but hidden by the following CSS rule:</div><div class=""><br class=""></div><pre style="margin-left:3ch" class="">.docs-body .section h1 {</pre><pre style="margin-left:3ch" class=""> display: none;</pre><pre style="margin-left:3ch" class="">}</pre><div class=""><br class=""></div><div class="">That works because we have the following HTML in the nova docs:</div><div class=""><br class=""></div><pre style="margin-left:3ch" class=""><div class="section" id="extra-specs"></pre><pre style="margin-left:3ch" class=""> <h1>Extra Specs<a class="headerlink" href="#extra-specs" title="Permalink to this headline">¶</a></h1></pre><pre style="margin-left:3ch" class=""> ...</pre><pre style="margin-left:3ch" class=""></div></pre><div class=""><br class=""></div><div class="">while the docs you linked are using the HTML5 semantic '<section>' tag:</div><div class=""><br class=""></div><pre style="margin-left:3ch" class=""><section id="nova-cells"></pre><pre style="margin-left:3ch" class=""> <h1>Nova Cells<a class="headerlink" href="#nova-cells" title="Permalink to this headline">¶</a></h1></pre><pre style="margin-left:3ch" class=""> ...</pre><pre style="margin-left:3ch" class=""></section></pre><div class=""><br class=""></div><div class="">So to fix this, we'll have to update the openstackdocstheme to handle these changes. I can try to take a look at this next week but I really wouldn't mind if someone beat me to it.</div><div class=""><br class=""></div><div class="">Stephen</div><div class=""><br class=""></div><div class="">[1] <a href="https://docs.openstack.org/nova/latest/configuration/extra-specs.html" target="_blank" class="">https://docs.openstack.org/nova/latest/configuration/extra-specs.html</a></div><div class=""><span class=""></span></div></div>
</blockquote></div>
</blockquote></div>
</blockquote></div>
</div></blockquote></div><br class=""></div></div></body></html>