Add layout footer correction

[jaclark5]

Despite the warning that sphinx_rtd_themes being incompatible with this GH Action, I pushed through using the mdanalysis_sphinx_theme which is based on the rtd theme. I'm not sure if this was the intention behind the warning, but the issue I saw is that the NIST footer was stuck at the top of the page.

By using the suggestion added to the docks here, I was able to get the NIST header and footer to be correctly placed in the documentation. See zenowrapper for an example.

[guyer]

Yes, I'm pretty sure this is the source of the warning about sphinx_rtd_theme. I think there should be a cross-reference from those warnings to your layout template explanation.

Also discovered (and will fix have fixed)

• archaic references to include-header-footer
• there's no obvious linkage to the Customization page
  • Hmmm... there are toctree entries in index.html, but they don't render for some reason
  • Hasn't worked since v0.3
  • Because they're :hidden:? Why did I hide them⁉️
  • Fixed on main. Rebase to get them in this PR.

[jaclark5]

@guyer is there anything I need to do for this PR?

[guyer]

@guyer is there anything I need to do for this PR?

@jaclark5 If you can, please troubleshoot the error in my review comment. I don't see anything obvious wrong with your jinja code-block, but sphinx errors and it does not appear in the generated docs.

I don't know why the CI passes anyway.

[jaclark5]

@guyer I merged the main branch and fixed the docs issue. I needed a blank line after ..code-block
*facepalm*

I downloaded the artifacts and viewed the html locally, it looks as expected.