Commit Graph
4127 Commits
Author SHA1 Message Date
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
Adam Turner 465b758a35 Extract `_generate_directives() from Documenter._generate()` (#13985) 2025-10-22 00:23:22 +01:00
Adam Turner fdf5411c1c Remove `DocumenterBridge` (#13984) 2025-10-21 19:06:53 +01:00
Adam Turner b5870e6904 Extract the `_docstring_source_name()` function (#13972) 2025-10-19 19:31:15 +01:00
Adam Turner c58caeffd7 Treat `Documenter.indent` as a constant (#13960) 2025-10-17 02:08:46 +01:00
Adam Turner f194178967 Use a new `_best_object_type_for_member()` function (#13961) 2025-10-17 01:56:54 +01:00
Adam Turner 4c89a82c1d Improve signature handling in autodoc (#13955) 2025-10-16 18:54:18 +01:00
ad3f3cc062 Add initial support for PEP 695 type aliases (#13508)
Signed-off-by: Martin Matous <m@matous.dev>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: Jeremy Maitin-Shepard <jbms@google.com>
2025-10-10 01:41:42 +01:00
Stephen FinucaneandAdam Turner 44a98961b2 Use hyphenated version directives (#13714)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-10-06 00:10:35 +01:00
Jared DillardandAdam Turner 8dd7a23fec Add warning sub-type for duplicate equation label warnings (#13929)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-10-05 03:59:09 +01:00
Tamika Nomara e92900948e Update list of maintained third-party domains (#13919) 2025-10-05 03:13:09 +01:00
Matthew Foster WalshandAdam Turner 10af407c3e Document `sphinx build -M help` (#13881)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-10-05 02:09:45 +00:00
Ugo 9a08711e0e Correct the example for the `seealso` directive (#13854) 2025-08-27 10:54:15 +01:00
Ch3ri0ur 85a12e255a Define the `code-py role in autosectionlabel.rst` (#13819) 2025-08-07 19:09:44 +01:00
duianto 01af04241b Add filename caption to tutorial code block (#13814) 2025-08-05 14:41:48 +01:00
Jean-François B. f92316a2f5 LaTeX: fix problems in our docs (in part inherited from #13805) (#13809) 2025-08-04 19:52:09 +02:00
Jean-François B. 5b3d92e7c6 LaTeX: support for using the fontawesome7 LaTeX package (#13805) 2025-08-04 09:55:36 +02:00
Adam Turner 67047523bf Prefer `props._obj to documenter.object` (#13804) 2025-08-03 18:18:56 +01:00
Adam Turner 3dddb1c53a Remove project extras (optional dependencies) (#13445) 2025-08-02 14:37:55 +01:00
Tim HoffmannandAdam Turner 3fd98d868a Rename `sphinx.ext.jsmath to sphinxcontrib.jsmath` (#13788)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2025-07-31 09:59:13 +01:00
Adam Turner 5d3bb2e3b7 Support Docutils 0.22 (#13786) 2025-07-29 18:44:31 +01:00
Stephen Finucane 1adc61a7a2 Indicate preference for follow-up commits over force pushes (#13748) 2025-07-25 15:27:58 +01:00
Jean-François B. 7b4164a5f2 LaTeX: better choice for \tymax parameter (#13711) 2025-07-01 18:29:08 +00:00
Jean-François B. 5fd1462390 Update changes/5.3.rst to mention fix of #6740
Close #6740.
2025-06-30 18:01:03 +02:00
Jean-François B. 74c1686789 LaTeX: improve the table column widths computed by LaTeX itself
Fix #3447
Fix #8228

With this patch the legacy notion of "problematic cell" is almost
entirely removed, and LaTeX package tabulary will be used more often so
that column widths in tables may get better fit to actual contents.

This works well when the column contains cells with multiple paragraphs,
bullet lists, enumerated lists, or line blocks.  For cells with object
descriptions or admonitions, the column may not fit tightly to the
contents, but other columns will probably be improved.
2025-06-29 21:42:47 +02:00
Adam Turner 5221bfccd4 Refresh the list of third-party domains (#13691) 2025-06-24 01:20:48 +01:00
Adam Turner f1edefee45 Deprecate the `sphinx.io` module (#13682) 2025-06-19 11:53:44 +01:00
Adam Turner be6593b0de Prefer `current_document.docname` (#13669) 2025-06-16 20:37:08 +01:00
Adam Turner 551b842898 Deprecate support for source encodings other than UTF-8 (#13666) 2025-06-16 20:32:31 +01:00