<html><head></head><body><div>On Tue, 2021-05-11 at 11:14 -0400, Peter Matulis wrote:</div><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><div dir="ltr"><div>Hi, I'm hitting an oddity in one of my projects where the titles of all pages show up twice.</div><div> </div><div>Example:</div><div><br></div><a href="https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/wallaby/app-nova-cells.html">https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/wallaby/app-nova-cells.html</a><br><div><br></div><div>Source file is here:</div><div><br></div><div><a href="https://opendev.org/openstack/charm-deployment-guide/src/branch/master/deploy-guide/source/app-nova-cells.rst">https://opendev.org/openstack/charm-deployment-guide/src/branch/master/deploy-guide/source/app-nova-cells.rst</a><br></div><div><br></div><div>Does anyone see what can be causing this? It appears to happen only for the current stable release ('wallaby') and 'latest'.</div><div><br></div><div>Thanks,</div><div>Peter</div></div></blockquote><div><br></div><div>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><br></div><div>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><br></div><pre style="margin-left: 3ch;">.docs-body .section h1 {</pre><pre style="margin-left: 3ch;"> display: none;</pre><pre style="margin-left: 3ch;">}</pre><div><br></div><div>That works because we have the following HTML in the nova docs:</div><div><br></div><pre style="margin-left: 3ch;"><div class="section" id="extra-specs"></pre><pre style="margin-left: 3ch;"> <h1>Extra Specs<a class="headerlink" href="#extra-specs" title="Permalink to this headline">¶</a></h1></pre><pre style="margin-left: 3ch;"> ...</pre><pre style="margin-left: 3ch;"></div></pre><div><br></div><div>while the docs you linked are using the HTML5 semantic '<section>' tag:</div><div><br></div><pre style="margin-left: 3ch;"><section id="nova-cells"></pre><pre style="margin-left: 3ch;"> <h1>Nova Cells<a class="headerlink" href="#nova-cells" title="Permalink to this headline">¶</a></h1></pre><pre style="margin-left: 3ch;"> ...</pre><pre style="margin-left: 3ch;"></section></pre><div><br></div><div>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><br></div><div>Stephen</div><div><br></div><div>[1] <a href="https://docs.openstack.org/nova/latest/configuration/extra-specs.html">https://docs.openstack.org/nova/latest/configuration/extra-specs.html</a></div><div><span></span></div></body></html>