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 and Adam Turner
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 and Adam Turner
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 and Adam Turner
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 and Adam Turner
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 and Adam Turner
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
Chris Sewell
41b363dbff
[rst] Add level option to rubric directive ( #12506 )
...
This commit adds a `level` option to the `rubric` directive, which propagates a `level` attribute to the `rubric` node,
and allows renderers to select a specific heading level.
Logic for this attribute has been added to the HTML5 and LaTeX builder.
2024-07-14 05:52:58 +02:00
Jean-François B
aa6dac81ec
LaTeX: Revamp the styling of all admonitions ( #12508 )
...
In LaTeX output, all admonitions now also have a title row with icon.
The ``xcolor`` LaTeX package is now required and the ``fontawesome5`` LaTeX package is needed for the icons.
2024-07-13 17:33:22 +01:00
Jean-François B
e49e2933bb
LaTeX: Use the babel LaTeX package by default for 'lualatex' with French ( #12557 )
...
Previously ``polyglossia`` was used by default.
2024-07-13 09:02:43 +01:00