Feature parity with upstream
Where this port diverges from the upstream PyData Sphinx Theme user guide — either because a feature has no meaningful Hugo equivalent, or because it’s declared but not yet implemented in this port’s templates.
| Upstream feature | Status here | Why |
|---|---|---|
Version switcher dropdown (switcher, check_switcher) | Not implemented | No switcher/version-JSON mechanism exists in this port’s params or templates. |
Version warning banner (show_version_warning_banner) | Not implemented | Depends on the version switcher above. |
Google Analytics / Plausible injection (analytics) | Not implemented | No analytics param or script-injection partial exists; add your own via a site-level content_footer_items/footer_end partial if needed. |
i18n message catalogs (gettext/pybabel) | Not applicable | Sphinx-specific tooling. Hugo has its own multilingual/i18n system , unrelated to this theme’s params. |
“Edit this page” / “view source” buttons (use_edit_page_button, html_context) | Not implemented | No equivalent partial exists yet in this port. |
Sphinx indices (genindex/modindex/py-modindex) | Not applicable | These are Sphinx/Python-doc-specific autogenerated indices with no Hugo concept to map to. |
| ABlog / sphinx-design / sphinx-togglebutton integration | Not applicable | These are Sphinx extensions. Hugo handles equivalent needs (blogging, callouts) through its own content/shortcode mechanisms, outside this theme’s scope. |
| sphinx-copybutton (copy-to-clipboard on code blocks) | Implemented | Ported natively as a codeblock render hook — every fenced code block gets a copy button automatically, no shortcode needed. |
| MathJax / math roles | Not applicable | No math rendering integration in this port. |
Pygments light/dark syntax style (pygments_light_style/pygments_dark_style) | Not implemented | Hugo’s Chroma highlighter is configured at the site level ([markup.highlight]), not through a theme param — see Styling
. |
show_nav_level | Declared, not implemented | Present in hugo.toml defaults (carried over from Sphinx’s theme.conf), but no template logic reads it — the sidebar tree always renders fully expanded. |
navigation_depth | Declared, not implemented | Same as above. |
collapse_navigation | Declared, not implemented | Same as above. |
icon_links_label | Declared, not implemented | No template currently renders this label. |
| ReadTheDocs-specific integration (flyout menu, ethical ads sidebar) | Not applicable | Specific to the ReadTheDocs hosting platform. |
sphinx-remove-toctrees / stub-page pruning | Not applicable | Toctree-driven sidebar generation is a Sphinx concept; this port’s sidebar is menu-driven (see Menus ). |
If you need any of the “not implemented” rows above, contributions are welcome — see the module’s README.md for how to work on this repo locally.