Commit Graph
3898 Commits
Author SHA1 Message Date
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 TranandAdam 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 SewellandAdam 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 AddisonandAdam 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 SewellandAdam 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
danieleadesandAdam 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