[GRASS-git] [OSGeo/grass] 67a183: docs: Fix libpython Sphinx canonical and sitemap v...

[Corey White]

  Branch: refs/heads/main
  Home:   https://github.com/OSGeo/grass
  Commit: 67a183c537009b0e4ec03e899d7162fa2e5b0406
      https://github.com/OSGeo/grass/commit/67a183c537009b0e4ec03e899d7162fa2e5b0406
  Author: Corey White <smortopahri at gmail.com>
  Date:   2026-07-24 (Fri, 24 Jul 2026)

  Changed paths:
    M .github/workflows/documentation.yml
    M python/grass/docs/conf.py
    M utils/merge_sitemaps.py
    A utils/test_merge_sitemaps.py

  Log Message:
  -----------
  docs: Fix libpython Sphinx canonical and sitemap version (#5935) (#7760)

* docs: Fix libpython canonical and sitemap URLs (#5935)

conf.py set html_baseurl twice. The second assignment (the bare domain root,
added for sphinx-sitemap) overwrote the canonical base, so every libpython page
emitted a bare-root canonical, and the sitemap scheme injected the full dev
version (grass8.6.0dev), producing 404 URLs.

Use a single html_baseurl built from the short numbered prefix
(https://grass.osgeo.org/grass<MAJOR><MINOR>/manuals/libpython/) and set the
sitemap scheme to "{link}", so canonical and sitemap URLs are identical and
resolve to the published grass86 tree.

Make merge_sitemaps.py preserve each source sitemap's URLs by default (the
--version rewrite is now opt-in) and drop the --version override in
documentation.yml, so the merged manuals sitemap keeps grass-stable manuals and
grass86 libpython URLs. Add a unit test for check_url_version.

Drafted with AI assistance.

* docs: Use grass-stable canonical for libpython to match core manuals

Per review feedback (OSGeo/grass#7760): keep the stable manuals tree as the
absolute canonical base instead of the numbered grassMAJORMINOR tree. This
matches the MkDocs core manuals (site_url = .../grass-stable/manuals/) so the
merged sitemap is uniformly grass-stable, and leaves dev-URL rewriting to CI.



To unsubscribe from these emails, change your notification settings at https://github.com/OSGeo/grass/settings/notifications