Commit Graph

20100 Commits

Author SHA1 Message Date
Adam Turner
e3567bfb16 Update CHANGES for Sphinx 6.2.0 2023-03-24 01:05:15 +00:00
Adam Turner
f5c957597d Normalise spelling of Sphinx versions 2023-03-24 00:44:33 +00:00
Adam Turner
97f07ca83c Speed up `test_linkcheck` 2023-03-24 00:29:27 +00:00
Adam Turner
9df3b59e00 Resolve lint errors from Ruff 0.0.259 2023-03-23 21:58:49 +00:00
Dmitry Shachnev
54f531e978
Remove obsolete workarounds in `doc/conf.py` (#11250)
Loading jQuery is not needed since January 2023:
https://github.com/readthedocs/readthedocs.org/pull/9861

And exposing app.{info,warn,debug} is not needed since September 2018:
https://github.com/readthedocs/readthedocs-sphinx-ext/pull/51
2023-03-23 21:42:28 +00:00
Benjamin Balder Bach
eda388a506
Docs: Add a link to sphinx-extensions (#11260) 2023-03-23 08:33:16 +01:00
Rafael Fontenelle
036b69b9bb Add missing quotes in html 4 deprecation text 2023-03-21 21:01:23 +01:00
Jean-François B
a07e1ffb27 LaTeX: comment applied workaround to pict2e 0.4b breaking ellipse.sty 2023-03-20 10:34:35 +01:00
Jean-François B
ec25892dd9 LaTeX: doc updates
modified:   doc/latex.rst
2023-03-20 10:34:15 +01:00
Jean-François B
8ed2c6708d LaTeX: update doc, trim unneeded extra examples 2023-03-20 00:10:31 +01:00
Jean-François B
baba5d3119 LaTeX: unneeded 4 code lines from #11254 trimmed
At some point after having inserted these extras I had ensured that rx
and ry where either both zero or both positive, making them unneeded.
2023-03-19 22:38:49 +01:00
Jean-François B
8289444c18 Update CHANGES for PR #11254 2023-03-19 21:59:04 +01:00
Jean-François B
de60cd8618 LaTeX: support elliptical corners in rounded boxes 2023-03-19 21:47:03 +01:00
Jean-François B
f78d86554c LaTeX: remove more-or-less obsolete doc 2023-03-19 21:23:06 +01:00
Jean-François B
cf6273a6b1 LaTeX: fix nits with some mark-up in doc and code comment 2023-03-19 19:09:08 +01:00
Jean-François B
c951f5f639 Update CHANGES 2023-03-19 18:39:45 +01:00
Jean-François B
b433d4cb9d LaTeX: warn about \sphinxbox addstrut default possibly changed at 7.0.0 2023-03-19 18:33:13 +01:00
Jean-François B
6bf40599e2 LaTeX: add <prefix>_{TeXcolor,TeXextras} options
And add <type>TextColor and <type>TeXextras for <type>=hint, important,
note, tip for variants which do not trigger for sphinxheavybox but
still uses sphinxlightbox (suitably enhanced).

Similar named TeXcolor and TeXextras options for \sphinxbox.
2023-03-19 18:29:09 +01:00
Jean-François B
0194aae8a5 LaTeX: refactor some internals related to color names 2023-03-19 18:28:40 +01:00
Jean-François B
4d7347cf1b LaTeX: reset options in nested \sphinxbox'es 2023-03-19 18:28:37 +01:00
Adam Turner
2ee7d0f678 Resolve lint errors from Ruff 0.0.257 2023-03-18 14:59:20 +00:00
Adam Turner
17d4dfa7fb Remove useless compatability imports
This exposed names at ``sphinx.builders.html.sphinxcontrib.serializinghtml``,
etc, which offers no benefit. This was originally broken in commit
9dfbfbf16b, four years ago.
2023-03-17 21:32:52 +00:00
Adam Turner
69066d0bb7 Split `sphinx.application.builtin_extensions` into groups
This is a preparatory step for when eventually the ``sphinxcontrib``
extensions are no longer loaded by default.
2023-03-17 21:22:19 +00:00
Adam Turner
075986c508 Miscellaneous `intersphinx` refactors
- Refactor usage of ``inventories.cache`` in ``load_mappings()``
- Iterate once over ``cached_vals``
- Avoid a line continuation character in ``_resolve_reference()``
2023-03-17 17:43:44 +00:00
Adam Turner
3d2114214b Improve static typing in `intersphinx` et al 2023-03-17 17:43:23 +00:00
Adam Turner
ae9008b128 Require Docutils 0.18.1 or greater
``Node.findall()`` was introduced in `Docutils 0.18.1`__

__ https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-18-1-2021-12-23
2023-03-17 17:32:30 +00:00
Adam Turner
2902c6c55b
Deprecate legacy `intersphinx_mapping` format (#11247)
This format was made obsolete in Sphinx 1.0, but never formally deprecated.
2023-03-17 16:41:22 +00:00
Jeremy Maitin-Shepard
7a4ce71f6b
Include source in highlighting warnings (#11150)
If pygments fails to lex a source string as the specified highlight
language, Sphinx prints a warning.  Previously, that warning did not
include the actual source text, although it does include location
information.

However, in some cases the location information may be missing, there
may be multiple highlighted literals on the same line, or the rST is
automatically generated somehow.  In such cases, it can be difficult
to determine the source text that led to the error.

With this change, the source text is included in the warning.
2023-03-17 15:32:27 +00:00
danieleades
2f03886d55
Remove deprecated code in `sphinx.builders.linkcheck` (#11089)
Co-authored-by: daniel.eades <daniel.eades@hotmail.com>
2023-03-17 15:24:38 +00:00
github-actions[bot]
c8f5e14488
[bot]: Update message catalogues (#10889)
Co-authored-by: AA-Turner <AA-Turner@users.noreply.github.com>
2023-03-17 15:18:36 +00:00
Hugo van Kemenade
ba4c67b1dc
Display examples of roles in the documentation (#11226)
Show examples of roles in the docs so we can see how they look. 
Seeing how roles are displayed helps us decide whether to use them.
2023-03-17 15:05:09 +00:00
Jean Abou-Samra
b7345ad066
Split up logic in `sphinx.transforms.i18n.Locale.apply` (#11166)
Before, the apply method was one big 400-line chunk. This just splits it
up into more manageable chunks by introducing a ``_NodeUpdater`` auxiliary
class holding logic for updating various types of references.

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-03-15 22:52:18 +00:00
Jean-François B
ed97d7ac9f Update CHANGES for PR #11243 2023-03-15 17:59:43 +01:00
Jean-François B
e80c1e6b31 LaTeX: let rounded boxes support up to 4 distinct border-widths
Internally replace "strokepath" operation for drawing the border
(which mandated constant border-width) by only "fillpath" operations.
This also allowed to significantly simplify some other aspects of the
code related to box-decoration-break=slice.
2023-03-15 17:59:43 +01:00
Jean-François B
988d2eafae LaTeX: fix a ad3235421 regression with pre_box-shadow-TeXcolor
The internally used color name for the (optional) shadow of
code-blocks had changed at one place but not another, so
using pre_box-shadow-TeXcolor option of 'sphinxsetup'
with latex_elements was broken since.
2023-03-15 17:59:43 +01:00
Adam Turner
a846f958bc Properly quote a string value in `transifex.yml` 2023-03-15 15:47:25 +00:00
Adam Turner
57545d0789 Update translations workflow for new `tx` client 2023-03-15 15:45:36 +00:00
Adam Turner
4d6aa53ae4 Refactor `utils/babel_runner.py` 2023-03-15 14:35:03 +00:00
Adam Turner
c2529e0a5e Ignore `PLC1901` in Ruff 2023-03-15 14:35:03 +00:00
Jean-François B
780fc6b15d Dummy commit to re-launch Windows CI (instance of #11232) 2023-03-15 01:03:31 +01:00
Jean-François B
f6c6da54a7 LaTeX: fix rounded boxes stroke twice their borders 2023-03-15 00:30:25 +01:00
Jean-François B
78e14fb6ba LaTeX: add boolean option addstrut to \sphinxbox/\sphinxboxsetup 2023-03-14 23:52:32 +01:00
Jean-François B
ee3c720cfa LaTeX: also admonition directives support box-decoration-break=slice 2023-03-13 19:50:31 +01:00
Jean-François B
27b30bba01 LaTeX: add support for div.topic_box-decoration-break=slice
It is however undecided if the slice style should suppress the
horizontal shadow forcefully.  It does not so far.

This commit has removed the \spx@ShadowFBox macro which got so
simple that its meaning could be put directly into \FrameCommand
definition.
2023-03-13 19:50:31 +01:00
Jean-François B
66c819ee21 LaTeX: refactoring of some internals from box-decoration-break support 2023-03-13 17:28:54 +01:00
Jean-François B
ff32c15ce0 LaTeX: comments following up on regression fix commit in sphinxShadowBox 2023-03-13 17:28:49 +01:00
Jean-François B
8b7758160e LaTeX: fix a regression revealed by test_includegraphics_oversized 2023-03-13 12:54:59 +01:00
Jean-François B
99863fb080 LaTeX: encapsulate dimension options in \dimexpr 2023-03-13 12:25:47 +01:00
Jean-François B
16a62a86ce LaTeX: guard against non-available xcolor in setting \sphinxbox defaults 2023-03-13 10:51:20 +01:00
Jean-François B
85fbfe1fa9 LaTeX: polish code comments 2023-03-13 10:47:01 +01:00