4155 Commits
Author SHA1 Message Date
Stewyn ff1bc8cf31 Add a glossary entry for 'doctree' (#2909) (#14728) 2026-10-23 13:22:17 -07:00
Jared Dillard fceed642c3 Clarify version-added body vs argument parsing (#14630) 2026-10-23 13:21:23 -07:00
Jared Dillard 7967688dd5 Clarify access to pending_xref attributes (#14646) 2026-10-23 13:19:51 -07:00
Jared Dillard 934d19e900 Clarify the name passed to autodoc-skip-member (#14629) 2026-10-23 13:19:07 -07:00
parulin ef672916c8 Use `:code-py:` for configuration value defaults (#14560) 2026-10-23 13:12:43 -07:00
Ronald Eddy Jr 9db1715c18 Add an example for the `envvar` directive (#14295) 2026-10-22 17:19:51 -07:00
Jared Dillard 96128b83f5 Doc: explain Napoleon configuration for import aliases (#14642) 2026-10-22 17:10:45 -07:00
Jared Dillard fbcc44a86f Document sphinx-apidoc extension options (#14647) 2026-10-22 17:10:10 -07:00
Jared Dillard 8f45c80ed5 Remove outdated HTML-only note for `modindex_common_prefix` (#14648) 2026-10-22 17:09:31 -07:00
Jared Dillard b90566db2a Document that cross-reference modifiers ! and ~ cannot be combined (#14582) 2026-10-22 17:03:32 -07:00
Anatoli Babenia 6778474eab docs: Give each theme a URL (#14404) 2026-10-22 15:14:57 -07:00
whnandJared Dillard ecab3746cf Document autodoc native module stubs environment variable (#14563)
Co-authored-by: Jared Dillard <jared.dillard@gmail.com>
2026-10-21 18:02:01 -07:00
Shengyu Zhang f5103eccf4 Mark `env.{docname, parser}` as per-document attributes (#14232) 2026-10-21 13:57:44 -07:00
e3f088c29d Document sphinx.testing (#14205)
Co-authored-by: Pradyun Gedam <pradyunsg@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Jared Dillard <jared.dillard+github@gmail.com>
Co-authored-by: Jared Dillard <jared.dillard@gmail.com>
2026-10-21 12:42:07 -07:00
Adam Turner 8ffd1ad8c3 Bump ty to 0.0.90 (#14763) 2026-10-20 15:13:07 -07:00
Adam Turner 9448f26ec6 Drop support for Python 3.12 (#14762) 2026-10-20 14:11:44 -07:00
Adam Turner 943bf0d191 Use Ruff rule names in place of codes (#14761) 2026-10-20 13:23:50 -07:00
Jonathan Dung c1b618c559 Fix grammatical mistakes in sphinx.ext.viewcode documentation (#14505) 2026-06-30 18:10:10 +02:00
Tim PillingerandBénédikt Tran 581c0860df Document graphviz requirement for sphinx.ext.graphviz (#14487)
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2026-06-15 08:51:10 +02:00
Jared Dillard 15b45be903 Document incompatible changes for HTML builder render_partial method in 9.x (#14488) 2026-06-14 18:46:20 +02:00
Jared DillardandBénédikt Tran bc5837b0a8 Add AI policy page (#14473)
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2026-06-09 05:25:35 +00:00
MJSHANG c0711783d6 Fix typos in LaTeX files and v8.2 changelog (#14428) 2026-06-07 10:48:56 +02:00
Jared DillardandAdam Turner b127b9478a Add `app.add_static_dir()` for copying extension static files (#14219)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-12-31 14:58:12 +00:00
Jean-François B. 9ee5446c6c LaTeX: restore 1.7 documentation of literalblockcappos (#14224) 2025-12-29 09:56:26 +00:00
gerhardtgao 964424b3db Use the correct reference for using existing extensions (#14157) 2025-12-27 03:01:42 +00:00
Shengyu Zhang 37ceb97e72 Fix typo in "source-read" event parameter description (#14211) 2025-12-24 16:16:30 +00:00
gerhardtgaoandAdam Turner a20ca6371c Fix link to Docutils' `.. class::` directive (#14193)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-12-24 16:15:41 +00:00
Adam Turner ad0497b89d Drop support for Python 3.11 (#14153) 2025-12-05 22:12:06 +00:00
Adam Turner 0a577b8fcb Move Sphinx 9.0 CHANGES to doc/changes 2025-12-05 21:42:58 +00:00
7926051f69 Recommend `uv` for local development (#14148)
Co-authored-by: daniel.eades <daniel.eades@seebyte.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-12-03 22:06:09 +00:00
Adam Turner baffcf0935 autodoc: Deprecate mapping interface for options (#14140) 2025-12-01 16:12:47 +00:00
a22dfabe03 Permit filtering warnings generated during source code parsing (#13894)
Co-authored-by: Valentin Heinisch <valentin.heinisch@vector.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-11-30 10:08:15 +00:00
Shengyu Zhang 4a3bd13b6a js domain: Remove extra brackets from function arguments and errors (#13569) 2025-11-30 06:15:05 +00:00
Adam Turner 2502bfcaf1 autodoc: Improve type hints for events (#14126) 2025-11-30 04:41:39 +00:00
Adam Turner 1e5f2f9913 Improve event manager API documentation (#14122) 2025-11-30 00:02:39 +00:00
gerhardtgao aef44685df Fix formatting of 'configuration' section in `duration.rst` (#14115) 2025-11-29 01:26:07 +00:00
Matthias GeierandAdam Turner 483daf722d Use Mathjax v4 by default (#14080)
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-11-27 21:36:07 +00:00
Shengyu ZhangandTim Hoffmann 4fb724ca3d Update steps for "enable GitHub Pages on your repository" (#14096)
Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
2025-11-27 03:19:13 +00:00
user27182andAdam Turner 187a2d269c Add configuration options to the `duration` extension (#13469)
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-11-27 03:04:13 +00:00
Adam Turner 45e1ae646c Remove deprecated API (#14095) 2025-11-25 20:15:39 +00:00
Adam Turner 8256092f14 Retarget to Sphinx 9.0 (#14093) 2025-11-25 08:00:08 +00:00
Adam Turner 4ba30e2835 Restore the legacy implementation of autodoc for compatibility (#14091) 2025-11-25 07:04:14 +00:00
Kayce Basques 88dcaed764 Add historical context about Web Support (#13678) 2025-11-25 03:43:14 +00:00
Adam Turner 2ce07daa6a Update translation contribution guidance (#14083) 2025-11-25 03:36:18 +00:00
Dimitri Papadopoulos Orfanos 994a062c5f Fix typos found by codespell (#13992) 2025-11-24 23:07:38 +00:00
Shengyu Zhang 999627164e Fix code block caption of github workflow file in tutorial (#14019) 2025-11-24 22:45:46 +00:00
c06bfceee2 linkcheck: Allow case-insensitive URL comparisons (#14046)
Co-authored-by: James Addison <55152140+jayaddison@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-11-24 22:23:31 +00:00
Randolf ScholzandAdam Turner 67762d88a2 Add `mathjax_config_file` to load MathJax configuration from a file (#14025)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-11-24 20:59:21 +00:00
Adam Turner de745a9eaa Consolidate option spec processing into `_directive_options.py` (#14009) 2025-10-29 23:53:15 +00:00
Adam Turner 7993a8b36a Use more type aliases for autodoc event listeners (#14008) 2025-10-29 22:37:33 +00:00