build: Upgrade Sphinx

common-requirements.txt

@@ -1,8 +1,8 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile common-requirements.in -o common-requirements.txt
-alabaster==0.7.12
+alabaster==1.0.0
     # via sphinx
-anyio==4.4.0
+anyio==4.14.2
     # via
     #   elasticsearch
     #   starlette
@@ -37,15 +37,15 @@ click==8.1.3
     #   uvicorn
 colorama==0.4.6
     # via sphinx-autobuild
-docutils==0.18
+docutils==0.22.4
     # via
     #   myst-parser
     #   sphinx
     #   sphinxcontrib-opendataservices
     #   sphinxcontrib-opendataservices-jsonschema
 elastic-transport==9.2.1
     # via elasticsearch
-elasticsearch[requests]==9.3.0
+elasticsearch==9.3.0
     # via ocdsindex
 h11==0.16.0
     # via
@@ -81,23 +81,23 @@ jsonref==1.0.0.post1
     #   jscc
     #   ocdsextensionregistry
     #   sphinxcontrib-opendataservices-jsonschema
-linkify-it-py==1.0.1
+linkify-it-py==2.2.0
     # via -r common-requirements.in
 lxml==6.1.0
     # via ocdsindex
-markdown-it-py==2.2.0
+markdown-it-py==4.2.0
     # via
     #   mdit-py-plugins
     #   myst-parser
 markupsafe==2.1.1
     # via jinja2
-mdit-py-plugins==0.3.1
+mdit-py-plugins==0.6.1
     # via myst-parser
 mdurl==0.1.2
     # via markdown-it-py
 mypy-extensions==1.1.0
     # via trio-typing
-myst-parser==0.18.1
+myst-parser==5.1.0
     # via
     #   -r common-requirements.in
     #   sphinxcontrib-opendataservices
@@ -144,6 +144,8 @@ requests==2.33.0
     #   sphinx
 requests-cache==1.1.0
     # via ocdsextensionregistry
+roman-numerals==4.1.0
+    # via sphinx
 rpds-py==2026.6.3
     # via referencing
 selenium==4.40.0
@@ -154,30 +156,29 @@ six==1.16.0
     #   url-normalize
 sniffio==1.3.1
     # via
-    #   anyio
     #   elastic-transport
     #   elasticsearch
     #   trio
-snowballstemmer==2.1.0
+snowballstemmer==3.1.1
     # via sphinx
 sortedcontainers==2.4.0
     # via trio
-sphinx==5.3.0
+sphinx==9.1.0
     # via
     #   -r common-requirements.in
     #   myst-parser
     #   sphinx-autobuild
     #   sphinx-intl
     #   sphinxcontrib-opendataservices
-sphinx-autobuild==2024.9.3
+sphinx-autobuild==2025.8.25
     # via -r common-requirements.in
-sphinx-intl==2.2.0
+sphinx-intl==2.4.0
     # via -r common-requirements.in
-sphinxcontrib-applehelp==1.0.2
+sphinxcontrib-applehelp==2.0.0
     # via sphinx
-sphinxcontrib-devhelp==1.0.2
+sphinxcontrib-devhelp==2.0.0
     # via sphinx
-sphinxcontrib-htmlhelp==2.0.0
+sphinxcontrib-htmlhelp==2.1.0
     # via sphinx
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
@@ -187,9 +188,9 @@ sphinxcontrib-opendataservices-jsonschema==0.7.1
     # via
     #   -r common-requirements.in
     #   sphinxcontrib-opendataservices
-sphinxcontrib-qthelp==1.0.3
+sphinxcontrib-qthelp==2.0.0
     # via sphinx
-sphinxcontrib-serializinghtml==1.1.5
+sphinxcontrib-serializinghtml==2.0.0
     # via sphinx
 starlette==1.3.1
     # via sphinx-autobuild
@@ -209,14 +210,11 @@ types-urllib3==1.26.25.14
 typing-extensions==4.15.0
     # via
     #   elasticsearch
-    #   myst-parser
     #   selenium
     #   trio-typing
-uc-micro-py==1.0.1
-    # via linkify-it-py
 url-normalize==1.4.3
     # via requests-cache
-urllib3[socks]==2.7.0
+urllib3==2.8.0
     # via
     #   elastic-transport
     #   requests

docs/conf.py

@@ -11,7 +11,6 @@
 
 from babel.messages.mofile import write_mo
 from babel.messages.pofile import read_po
-from docutils.nodes import make_id
 from ocds_babel.translate import translate
 from ocdskit.mapping_sheet import mapping_sheet
 from sphinx.locale import get_translation
@@ -69,9 +68,7 @@
 # MyST configuration.
 myst_enable_extensions = ["linkify"]
 myst_heading_anchors = 6
-myst_heading_slug_func = make_id
-# https://github.com/executablebooks/MyST-Parser/issues/357
-suppress_warnings = ["myst.anchor"]
+myst_heading_slug_func = "docutils.nodes.make_id"
 
 # Theme customization.
 navigation_with_keys = False  # restore the Sphinx default
@@ -111,7 +108,7 @@
     # Ignore unwanted links created by linkify.
     r"^http://vnd\.",
     # Ignore expected redirects.
-    r"^https://docs.google.com/spreadsheets/d/[^/]+/pub?gid=\d+&single=true&output=csv$",
+    r"^https://docs\.google\.com/spreadsheets/d/e/[^/]+/pub\?gid=\d+&single=true&output=csv$",
 ]
 
 
@@ -125,7 +122,20 @@ def compile_catalogs(localedir, language, domains):
             write_mo(f, catalog, use_fuzzy=True)
 
 
+def restore_myst_slugs(app, doctree):
+    """Restore the page's heading slugs, which MyST overwrites when parsing a translated title."""
+    # https://github.com/executablebooks/MyST-Parser/issues/844
+    slugs = getattr(doctree, "myst_slugs", None)
+    metadata = app.env.metadata[app.env.docname]
+    if slugs:
+        metadata["myst_slugs"] = slugs
+    else:
+        metadata.pop("myst_slugs", None)
+
+
 def setup(app):
+    app.connect("doctree-read", restore_myst_slugs)
+
     # The root of the repository.
     basedir = Path(__file__).resolve().parents[1]
     # `LOCALE_DIR` from `config.mk`.

docs/locale/es/LC_MESSAGES/guidance/map/localization.po

@@ -348,8 +348,8 @@ msgid ""
 msgstr ""
 "El equipo de desarrollo del estándar de OCDS mantiene las traducciones "
 "**admitidas** de acuerdo a la [política de traducción y "
-"localización](../../governance/index.md#translation-and-localization-"
-"policy). Los voluntarios contribuyen con traducciones **comunitarias.**"
+"localización](../../governance/translation). Los voluntarios contribuyen "
+"con traducciones **comunitarias.**"
 
 #: ../../docs/guidance/map/localization.md:79
 msgid ""

docs/locale/es/LC_MESSAGES/history/changelog.po

@@ -1657,7 +1657,7 @@ msgid ""
 "upgrades."
 msgstr ""
 "[#401](https://github.com/open-contracting/standard/issues/401) **[Política "
-"de descontinuación](../schema/conformance_and_extensions/)** - La política "
+"de descontinuación](../schema/conformance_and_extensions)** - La política "
 "de descontinuación ha sido actualizada para soportar la descontinuación en "
 "las actualizaciones decimales."
 

docs/locale/es/LC_MESSAGES/primer/how.po

@@ -78,11 +78,16 @@ msgstr "Licitación"
 
 #: ../../docs/primer/how.md:32
 msgid ""
-"**Tender**\\ *Including:*\\ Tender notices\\ Specifications\\ Line items\\ "
-"Values\\ Enquiries"
+"**Tender** *Including:* Tender notices Specifications Line items Values "
+"Enquiries"
 msgstr ""
-"**Licitación**\\ *Incluye:*\\ Avisos de licitación\\ Especificaciones\\ "
-"Partidas\\ Valores\\ Consultas"
+"**Licitación**\\\n"
+"*Incluye:*\\\n"
+"Avisos de licitación\\\n"
+"Especificaciones\\\n"
+"Partidas\\\n"
+"Valores\\\n"
+"Consultas"
 
 #: ../../docs/primer/how.md:44
 msgid "![Award](../_static/svg/green_awarded.svg)"
@@ -94,11 +99,15 @@ msgstr "Adjudicación"
 
 #: ../../docs/primer/how.md:46
 msgid ""
-"**Award**\\ *Including:*\\ Details of award\\ Bidder information\\ Bid "
-"evaluation\\ Values"
+"**Award** *Including:* Details of award Bidder information Bid evaluation"
+" Values"
 msgstr ""
-"**Adjudicación**\\ *Incluye:*\\ Detalles del adjudicación\\ \"Información "
-"del licitante\\ Evaluación de la oferta\\ Valores"
+"**Adjudicación**\\\n"
+"*Incluye:*\\\n"
+"Detalles del adjudicación\\\n"
+"Información del licitante\\\n"
+"Evaluación de la oferta\\\n"
+"Valores"
 
 #: ../../docs/primer/how.md:57
 msgid "![Contract](../_static/svg/green_signed.svg)"
@@ -109,12 +118,14 @@ msgid "Contract"
 msgstr "Contrato"
 
 #: ../../docs/primer/how.md:59
-msgid ""
-"**Contract**\\ *Including:*\\ Final details\\ Signed contract\\ Amendments\\"
-" Values"
+msgid "**Contract** *Including:* Final details Signed contract Amendments Values"
 msgstr ""
-"**Contrato**\\ *Incluye:*\\ Detalles finales\\ Contrato firmado\\ "
-"Enmiendas\\ Valores"
+"**Contrato**\\\n"
+"*Incluye:*\\\n"
+"Detalles finales\\\n"
+"Contrato firmado\\\n"
+"Enmiendas\\\n"
+"Valores"
 
 #: ../../docs/primer/how.md:70
 msgid "![Implementation](../_static/svg/green_implementation.svg)"
@@ -126,12 +137,17 @@ msgstr "Implementación"
 
 #: ../../docs/primer/how.md:72
 msgid ""
-"**Implementation**\\ *Including:*\\ Payments\\ Progress updates\\ Location\\"
-" Extensions\\ Amendments\\ Completion or Termination info"
-msgstr ""
-"**Implementación**\\ *Incluye:*\\ Pagos\\ Actualizaciones de progreso\\ "
-"Ubicación\\ Extensiones\\ Enmiendas\\ Información de finalización o "
-"terminación"
+"**Implementation** *Including:* Payments Progress updates Location "
+"Extensions Amendments Completion or Termination info"
+msgstr ""
+"**Implementación**\\\n"
+"*Incluye:*\\\n"
+"Pagos\\\n"
+"Actualizaciones de progreso\\\n"
+"Ubicación\\\n"
+"Extensiones\\\n"
+"Enmiendas\\\n"
+"Información de finalización o terminación"
 
 #: ../../docs/primer/how.md:87
 msgid ""

docs/locale/es/LC_MESSAGES/sphinx.po

@@ -47,3 +47,7 @@ msgstr "Idioma"
 #: ../../docs/_templates/layout.html:31
 msgid "Supported translations"
 msgstr "Traducciones soportadas"
+
+#, python-format
+msgid "Added in version %s"
+msgstr "Añadido en la versión %s"

requirements.txt

@@ -4,5 +4,5 @@
 # Add your own requirements below.
 
 ocdskit==1.3.0
-sphinx-design==0.4.1
-sphinxcontrib-opencontracting==0.0.8
+sphinx-design==0.7.0
+sphinxcontrib-opencontracting==0.0.11

tests/__init__.py

@@ -11,8 +11,7 @@
 }
 
 test_search_params = [
-    ("en", r"found \d+ page\(s\) matching"),
-    # See https://github.com/sphinx-doc/sphinx/issues/11008
-    # ('es', r'encontraron \d+ páginas que coinciden'),  # noqa: ERA001
-    # ('fr', r'\d+ page\(s\) correspondant'),  # noqa: ERA001
+    ("en", r"Found \d+ pages matching"),
+    ("es", r"encontraron \d+ páginas que coinciden"),
+    ("fr", r"\d+ pages correspondant"),  # codespell:ignore
 ]

tests/test_common.py

@@ -26,7 +26,7 @@ def test_search(browser, server, lang, regex):
 # This seems to be an issue in Selenium and/or ChromeDriver.
 @pytest.mark.filterwarnings("ignore:unclosed <socket.socket fd=:ResourceWarning")
 def test_language_switcher(browser, server):
-    if "localhost" in server:
+    if "localhost" in server or len(languages) < 2:
         pytest.skip()
 
     browser.get(f"{server}en/")