I'm now seeing this symptom on several projects in the 'latest' release branch. Such as:
https://docs.openstack.org/nova/latest/
My browser exposes the following error:
[image: image.png]
We patched [1] our project as a workaround.
Could one of Stephen's commits [2] be involved?
[1]: https://review.opendev.org/c/openstack/charm-deployment-guide/+/803531 [2]: https://opendev.org/openstack/openstackdocstheme/commit/08461c5311aa692088a2...
On Thu, Jun 10, 2021 at 3:51 PM Peter Matulis peter.matulis@canonical.com wrote:
Hi Stephen. Did you ever get to circle back to this?
On Fri, May 14, 2021 at 7:34 AM Stephen Finucane stephenfin@redhat.com wrote:
On Tue, 2021-05-11 at 11:14 -0400, Peter Matulis wrote:
Hi, I'm hitting an oddity in one of my projects where the titles of all pages show up twice.
Example:
https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/walla...
Source file is here:
https://opendev.org/openstack/charm-deployment-guide/src/branch/master/deplo...
Does anyone see what can be causing this? It appears to happen only for the current stable release ('wallaby') and 'latest'.
Thanks, Peter
I suspect you're bumping into issues introduced by a new version of Sphinx or docutils (new versions of both were released recently).
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:
.docs-body .section h1 {
display: none;
}
That works because we have the following HTML in the nova docs:
<div class="section" id="extra-specs">
<h1>Extra Specs<a class="headerlink" href="#extra-specs" title="Permalink to this headline">¶</a></h1> ...
</div>
while the docs you linked are using the HTML5 semantic '<section>' tag:
<section id="nova-cells">
<h1>Nova Cells<a class="headerlink" href="#nova-cells" title="Permalink to this headline">¶</a></h1> ...
</section>
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.
Stephen
[1] https://docs.openstack.org/nova/latest/configuration/extra-specs.html