Merge branch 'master' into add-dark-mode-toggle

Author: DivyaSimhadri1004

.github/workflows/main.yml

@@ -41,6 +41,7 @@ jobs:
         docutils:
         - "0.20"
         - "0.21"
+        - "0.22"
 #        include:
 #        # test every supported Docutils version for the latest supported Python
 #        - python: "3.13"
@@ -93,6 +94,7 @@ jobs:
         docutils:
         - "0.20"
         - "0.21"
+        - "0.22"
 
     steps:
     - uses: actions/checkout@v4

CHANGES.rst

@@ -4,6 +4,10 @@ Release 8.3.0 (in development)
 Dependencies
 ------------
 
+* #13786: Support `Docutils 0.22`_. Patch by Adam Turner.
+
+  .. _Docutils 0.22: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-22-2026-07-29
+
 Incompatible changes
 --------------------
 

doc/changes/7.3.rst

@@ -86,7 +86,7 @@ Dependencies
 
 * #11858: Increase the minimum supported version of Alabaster to 0.7.14.
   Patch by Adam Turner.
-* #11411: Support `Docutils 0.21`_. Patch by Adam Turner.
+* #12267: Support `Docutils 0.21`_. Patch by Adam Turner.
 
   .. _Docutils 0.21: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-21-2024-04-09
 * #12012: Use ``types-docutils`` instead of ``docutils-stubs``.

doc/internals/contributing.rst

@@ -205,7 +205,7 @@ You can also test by installing dependencies in your local environment:
 
   .. code-block:: shell
 
-     pip install .[test]
+     pip install . --group test
 
 To run JavaScript tests, use :program:`npm`:
 

doc/usage/extensions/math.rst

@@ -318,14 +318,25 @@ Sphinx but is set to automatically include it from a third-party site.
       This has been renamed to :confval:`mathjax2_config`.
       :confval:`mathjax_config` is still supported for backwards compatibility.
 
-:mod:`sphinx.ext.jsmath` -- Render math via JavaScript
-------------------------------------------------------
+:mod:`sphinxcontrib.jsmath` -- Render math via JavaScript
+---------------------------------------------------------
 
-.. module:: sphinx.ext.jsmath
+.. module:: sphinxcontrib.jsmath
    :synopsis: Render math using JavaScript via JSMath.
 
 This extension works just as the MathJax extension does, but uses the older
-package jsMath_.  It provides this config value:
+package jsMath_. jsMath is no longer actively developed, but it has the
+advantage that the size of the JavaScript package is much smaller than
+MathJax.
+
+.. versionadded:: 0.5
+   The :mod:`!sphinx.ext.jsmath` extension.
+.. versionchanged:: 2.0
+   :mod:`!sphinx.ext.jsmath` was moved to :mod:`sphinxcontrib.jsmath`.
+.. versionremoved:: 4.0
+   The alias from :mod:`!sphinx.ext.jsmath` to :mod:`sphinxcontrib.jsmath`.
+
+Config value:
 
 .. confval:: jsmath_path
    :type: :code-py:`str`
@@ -337,7 +348,7 @@ package jsMath_.  It provides this config value:
    The path can be absolute or relative; if it is relative, it is relative to
    the ``_static`` directory of the built docs.
 
-   For example, if you put JSMath into the static path of the Sphinx docs, this
+   For example, if you put jsMath into the static path of the Sphinx docs, this
    value would be ``jsMath/easy/load.js``.  If you host more than one
    Sphinx documentation set on one server, it is advisable to install jsMath in
    a shared location.
@@ -347,5 +358,5 @@ package jsMath_.  It provides this config value:
 .. _dvisvgm: https://dvisvgm.de/
 .. _dvisvgm FAQ: https://dvisvgm.de/FAQ
 .. _MathJax: https://www.mathjax.org/
-.. _jsMath: https://www.math.union.edu/~dpvc/jsmath/
+.. _jsMath: https://www.math.union.edu/~dpvc/jsMath/
 .. _LaTeX preview package: https://www.gnu.org/software/auctex/preview-latex.html

doc/usage/installation.rst

@@ -56,7 +56,7 @@ Run the following command::
    Or, if writing documentation for a Python package,
    place the dependencies in the `pyproject.toml file`__::
 
-      $ pip install .[docs]
+      $ pip install . --group docs
 
    __ https://pip.pypa.io/en/stable/reference/requirements-file-format/
    __ https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#dependencies-optional-dependencies

pyproject.toml

@@ -76,7 +76,7 @@ dependencies = [
     "sphinxcontrib-serializinghtml>=1.1.9",
     "Jinja2>=3.1",
     "Pygments>=2.17",
-    "docutils>=0.20,<0.22",
+    "docutils>=0.20,<0.23",
     "snowballstemmer>=2.2",
     "babel>=2.13",
     "alabaster>=0.7.14",
@@ -88,35 +88,6 @@ dependencies = [
 ]
 dynamic = ["version"]
 
-[project.optional-dependencies]
-docs = [
-    "sphinxcontrib-websupport",
-]
-lint = [
-    "ruff==0.12.5",
-    "mypy==1.17.0",
-    "sphinx-lint>=0.9",
-    "types-colorama==0.4.15.20240311",
-    "types-defusedxml==0.7.0.20250708",
-    "types-docutils==0.21.0.20250525",
-    "types-Pillow==10.2.0.20240822",
-    "types-Pygments==2.19.0.20250715",
-    "types-requests==2.32.4.20250611",  # align with requests
-    "types-urllib3==1.26.25.14",
-    "pyright==1.1.400",
-    "pytest>=8.0",
-    "pypi-attestations==0.0.27",
-    "betterproto==2.0.0b6",
-]
-test = [
-    "pytest>=8.0",
-    "pytest-xdist[psutil]>=3.4",
-    "defusedxml>=0.7.1", # for secure XML/HTML parsing
-    "cython>=3.0",
-    "setuptools>=70.0",  # for Cython compilation
-    "typing_extensions>=4.9",  # for typing_extensions.Unpack
-]
-
 [[project.authors]]
 name = "Adam Turner"
 email = "[email protected]"
@@ -136,7 +107,7 @@ docs = [
     "sphinxcontrib-websupport",
 ]
 lint = [
-    "ruff==0.12.5",
+    "ruff==0.12.7",
     "sphinx-lint>=0.9",
 ]
 package = [
@@ -158,14 +129,14 @@ translations = [
     "Jinja2>=3.1",
 ]
 types = [
-    "mypy==1.17.0",
+    "mypy==1.17.1",
     "pyrefly",
     "pyright==1.1.400",
     { include-group = "type-stubs" },
 ]
 type-stubs = [
     # align with versions used elsewhere
-    "types-colorama==0.4.15.20240311",
+    "types-colorama==0.4.15.20250801",
     "types-defusedxml==0.7.0.20250708",
     "types-docutils==0.21.0.20250525",
     "types-Pillow==10.2.0.20240822",
@@ -247,21 +218,15 @@ ignore_missing_imports = true
 [[tool.mypy.overrides]]
 module = [
     # tests/
-    "tests.test_project",
     "tests.test_versioning",
     # tests/test_builders
     "tests.test_builders.test_build",
     "tests.test_builders.test_build_html",
     "tests.test_builders.test_build_html_5_output",
-    "tests.test_builders.test_build_html_assets",
-    "tests.test_builders.test_build_html_maths",
-    "tests.test_builders.test_build_html_toctree",
     "tests.test_builders.test_build_linkcheck",
     # tests/test_directives
     "tests.test_directives.test_directive_code",
     "tests.test_directives.test_directives_no_typesetting",
-    # tests/test_environment
-    "tests.test_environment.test_environment",
     # tests/test_extensions
     "tests.test_extensions.test_ext_autodoc_autoclass",
     "tests.test_extensions.test_ext_autosummary_imports",
@@ -270,7 +235,6 @@ module = [
     "tests.test_extensions.test_ext_napoleon",
     # tests/test_markup
     "tests.test_markup.test_markup",
-    "tests.test_markup.test_parser",
     # tests/test_theming
     "tests.test_theming.test_templating",
     "tests.test_theming.test_theming",
@@ -329,7 +293,6 @@ check_untyped_defs = false
 disable_error_code = [
     "annotation-unchecked",
 ]
-disallow_incomplete_defs = false
 disallow_untyped_calls = false
 disallow_untyped_defs = false