Jean-François B.
bf431ed0d7
LaTeX: do not use `\small with FreeMono, but Scale=0.9` ( #12822 )
2024-08-25 17:07:49 +02:00
Jean-François B.
3d49941484
LaTeX: two lines lost in previous commit (docs) ( #12819 )
2024-08-23 18:15:40 +02:00
Jean-François B.
9943274033
LaTeX: clarify some docs, add syntax highlighting (refactoring) ( #12818 )
2024-08-23 18:04:38 +02:00
Frank Dana
e54982f27c
Fix typo in `sphinx-autogen` documentation ( #12809 )
2024-08-22 10:09:13 +01:00
Jean-François B.
1c131dfffe
LaTeX: make contents, topic, and sidebar separately customizable ( #12704 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-08-19 20:43:47 +02:00
Jean-François B.
0504903d47
Update changes/7.4.rst to quote fix of #8807 ( #12802 )
2024-08-19 09:11:14 +02:00
Thomas Fanning
e0f2009346
LaTeX: Add math_numsep support to latex builder ( #12652 )
...
Co-authored-by: Jean-François B <2589111+jfbu@users.noreply.github.com>
2024-08-18 21:34:20 +02:00
Jean-François B.
4c7fe10a4b
LaTeX: fix mark-up when \DUrole is used with multiple classes ( #12745 )
2024-08-17 20:33:15 +02:00
Adam Dangoor
cb455ddada
Add per-event overloads to `Sphinx.connect()` ( #12784 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-08-15 21:49:50 +01:00
Tim Hoffmann
49c3b21c60
Format directive options and add some missing ones ( #12779 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-08-14 20:59:50 +01:00
Adam Turner
fadb6b10cb
Stop exiting early with `--fail-on-warnings; add --exception-on-warning` ( #12743 )
...
Co-authored-by: Jeremy Maitin-Shepard <jbms@google.com>
2024-08-13 17:12:42 +01:00
Jeremy Bowman
0cbdd98ffb
Correctly support custom gettext output templates ( #12645 )
...
Co-authored-by: Jeremy Bowman <jmbowman@alum.mit.edu>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-08-11 20:34:04 +01:00
Tim Hoffmann
646a5d7482
Support type-dependent search result highlighting via CSS ( #12474 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: James Addison <55152140+jayaddison@users.noreply.github.com>
2024-08-11 20:22:21 +01:00
Adam Turner
be73e64a9f
Add `sphinx.util._files` ( #12766 )
2024-08-11 19:51:59 +01:00
nikkie
c6163ff442
Fix a typo in `extdev/testing.rst` ( #12765 )
2024-08-11 17:57:46 +01:00
Adam Turner
d39ba32604
Add `sphinx.util._importer` ( #12762 )
2024-08-11 17:24:26 +01:00
Tim Hoffmann
4cf8f7a093
Restructure documentation for the toctree directive ( #12725 )
...
Structure the options using `.. rst:directive:option::` and adapt some descriptions where suitable.
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-08-11 16:36:01 +01:00
Adam Turner
18fbced7e0
Reduce the formatter's target line length to 88 ( #12757 )
2024-08-11 00:19:50 +01:00
James Addison
e3238260f6
Migrate JavaScript tests from Karma to the Jasmine framework ( #12754 )
2024-08-10 00:18:27 +01:00
Adam Turner
f0365cda38
Add titles to version-specific changes files
2024-07-30 21:09:33 +01:00
Adam Turner
0afcd01b08
Restore a missing reference target
2024-07-30 21:09:33 +01:00
Adam Turner
add38d9862
Move Sphinx 8.0 CHANGES to a dedicated file
2024-07-30 21:09:33 +01:00
Adam Turner
0eb3e822b6
Move Sphinx 7.4 CHANGES to a dedicated file
2024-07-30 21:09:33 +01:00
Adam Turner
f3c2fcddd4
Move Sphinx 7.3 CHANGES to a dedicated file
2024-07-30 21:09:33 +01:00
Adam Turner
a5aacd01d7
Move Sphinx 7.2 CHANGES to a dedicated file
2024-07-30 21:09:33 +01:00
Adam Turner
40abc219e2
Move Sphinx 7.1 CHANGES to a dedicated file
2024-07-30 21:09:33 +01:00
Adam Turner
9f4c2a9a27
Move Sphinx 7.0 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
1dbd560d1c
Move Sphinx 6.2 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
0b6a052649
Move Sphinx 6.1 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
b658c1adb8
Move Sphinx 6.0 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
d7d3b7d085
Move Sphinx 5.3 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
f73e65bc43
Move Sphinx 5.2 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
6d8de59708
Move Sphinx 5.1 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
c835a3c9d3
Move Sphinx 5.0 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
da8bee123d
Move Sphinx 4.5 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
886dfe1884
Move Sphinx 4.4 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
7e343f8ba0
Move Sphinx 4.3 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
aeee30b898
Move Sphinx 4.2 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
e98008ac34
Move Sphinx 4.1 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
9ad128b6eb
Move Sphinx 4.0 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
5246cc8789
Move Sphinx 3.5 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
0f8e2bbe10
Move Sphinx 3.4 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
894b3b3a17
Move Sphinx 3.3 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
d662edeba1
Move Sphinx 3.2 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
d7fd6906c9
Move Sphinx 3.1 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
aa2e80dec8
Move Sphinx 3.0 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
3a63526f0e
Move Sphinx 2.4 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
79502cfa89
Move Sphinx 2.3 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
b8669af8d7
Move Sphinx 2.2 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
fcf16c6036
Move Sphinx 2.1 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
9d64d93947
Move Sphinx 2.0 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
d6678b3da7
Move Sphinx 1.8 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
ac5a761c69
Move Sphinx 1.7 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
a5492534a4
Move Sphinx 1.6 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
2811d45c91
Move Sphinx 1.5 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
0ccf15fae6
Move Sphinx 1.4 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
ed4c779334
Move Sphinx 1.3 CHANGES to a dedicated file
2024-07-30 21:09:32 +01:00
Adam Turner
f1e5c46cd3
Move Sphinx 1.2 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
c1aed0cfbe
Move Sphinx 1.1 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
16db2e0064
Move Sphinx 1.0 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
da816b34cc
Move Sphinx 0.6 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
885321fa7c
Move Sphinx 0.5 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
a2cf204ff0
Move Sphinx 0.4 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
9b15a8dcd2
Move Sphinx 0.3 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
f228c8a69b
Move Sphinx 0.2 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
b15eab035f
Move Sphinx 0.1 CHANGES to a dedicated file
2024-07-30 21:09:31 +01:00
Adam Turner
0a5a96ca15
Move doc/changes to doc/changes/index
2024-07-30 18:49:50 +01:00
Tim Hoffmann
feeee57dbe
[HTML theme] sphinx13: include the project name in home link ( #12700 )
2024-07-28 09:50:48 +02:00
Tim Hoffmann
08adbb3c18
Fix positioning of logos on the homepage ( #12684 )
2024-07-26 22:54:40 +01:00
Adam Turner
b511537597
`_StrPath is dead; long live _StrPath` ( #12690 )
2024-07-26 17:33:55 +01:00
Adam Turner
55eddad705
Use proper Pygments lexers
2024-07-24 15:21:25 +01:00
Adam Turner
b88905b6f7
Use long options to sphinx-build in our documentation
2024-07-24 15:21:25 +01:00
Adam Turner
fc808e0e90
Expand the `sphinx.testing` overview
2024-07-24 15:21:14 +01:00
Adam Turner
3b14b56939
Move the `sphinx.testing` overview to the API section
2024-07-24 15:21:14 +01:00
Adam Turner
7b6d448517
Update the contributor's guide
2024-07-24 15:21:14 +01:00
Adam Turner
7abf85a7f3
Update the Python version support policy to reflect SPEC 0
2024-07-23 23:40:45 +01:00
Adam Turner
eb2186490a
Use `copyfile` where possible
2024-07-23 22:36:10 +01:00
Adam Turner
772cdfa19d
Remove `sphinx.directives.other.VersionChange` ( #12662 )
2024-07-23 14:56:49 +01:00
Adam Turner
de15d61a46
Use pathlib in `sphinx.project`
2024-07-23 04:52:32 +01:00
Adam Turner
217f267822
Do not overwrite user-supplied data by default when copying ( #12647 )
2024-07-22 16:00:16 +01:00
Adam Turner
9e3f4521db
Drop support for Python 3.9 ( #12633 )
2024-07-22 15:05:15 +01:00
Adam Turner
e174df2762
Rename `normalize_intersphinx_mapping to validate_intersphinx_mapping` ( #12643 )
2024-07-22 13:32:44 +01:00
Bénédikt Tran
aacca3064e
Remove support for the Sphinx 0.5 `intersphinx_mapping` format ( #12083 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-07-22 12:59:59 +01:00
Tim Hoffmann
a79768847f
Improve the search field styling in the `sphinx13` theme ( #12591 )
2024-07-20 23:08:15 +01:00
Chris Sewell
dabacdf5f8
Turn `show_warning_types` on by default ( #12597 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-07-20 21:07:06 +01:00
James Addison
cc08854bc2
linkcheck: Update configuration defaults for Sphinx 8.0 ( #12630 )
...
- Links that respond with HTTP 401 (unauthorized) responses are now considered ``broken`` by default.
- Timeouts that occur when checking a link are now reported with a distinct `timeout` status code, instead of the previous ``broken``.
- The previous behaviours are still available and can be configured on an opt-in basis per-project using ``conf.py``.
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-07-20 20:41:22 +01:00
Adam Turner
93842508d2
Remove the `--no-use-make-mode` option from sphinx-quickstart
2024-07-20 19:40:29 +01:00
Jean-François B.
afaddd3c45
Update LaTeX docs with new admonition colours ( #12588 )
2024-07-15 18:28:40 +01:00
Adam Turner
18ac58bd53
Fix possibly-invalid HTML when a rubric node is manually created
2024-07-15 10:04:48 +01:00
Adam Turner
aeebfabe09
Add `include-read to the events overview; sort core_events` ( #12576 )
2024-07-15 05:06:26 +01:00
Chris Sewell
d8fa98e46a
Add a `write-started` event ( #12567 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-07-15 04:59:06 +01:00
danieleades
f4bb9ca112
Shrink the mypy whitelist: `sphinx.application` ( #12568 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-07-15 03:04:10 +01:00
Adam Turner
3456ff3ca3
Add all admonitions to `directives.rst` ( #12572 )
...
Also improve documentation for the *versionchanged* directives.
2024-07-15 02:26:05 +01:00
Adam Turner
0f38c9c15d
Emend various spelling errors
2024-07-15 02:16:34 +01:00
Adam Turner
7b570c06a1
Standardise on a common directive for describing code snippets
2024-07-15 02:15:52 +01:00
Adam Turner
1252c7b549
Use "rst" consistently for code and highlighting directives
2024-07-15 02:15:52 +01:00
Adam Turner
f2640a4286
Standardise on "reStructuredText" over "reST" in documentation
2024-07-15 02:15:52 +01:00
Adam Turner
26576590ed
Make the domain referencing role targets more specific
2024-07-15 01:59:42 +01:00
Tim Hoffmann
00758033d3
[docs] CSS style improvements ( #12546 )
...
- increase paragraph line-height to 1.5
- Adapt the border color for all warning/error like admonitions
2024-07-14 08:02:02 +02:00
Chris Sewell
cbf0b8e419
[docs] fix changelog include ( #12564 )
...
Use `include-read` instead of `source-read` for special content transform.
In-particular, this fixes an issue that `docs/changes.rst` would not re-build, when `CHANGES.rst` was changed.
2024-07-14 06:35:35 +02:00
