search

jbms / sphinx-immaterial

Adaptation of the popular mkdocs-material material design theme to the sphinx documentation system
https://jbms.github.io/sphinx-immaterial/
Other
177 stars 28 forks source link

sitemap generation does not support incremental builds #362

Open 2bndy5 opened 1 week ago

2bndy5 commented 1 week ago

The sphinx_immaterial.postprocess_html extension handles the generation of a sitemap, but it does not include unchanged pages' data from a previous builds. I believe this extension was inherited from sphinx-material theme.

This behavior has been adequate because docs are typically deployed from a fresh build. However, this lacking implementation may impact versioned docs using the version selector.

[!tip] For passersby, the sitemap is automatically generated when html_theme_options["site_url"] is configured.