doc/changes/7.4.rst
~typing.Annotated type
metadata in the Python domain.
Patch by Adam Turner.~typing.Annotated warnings with
sphinx.ext.autodoc,
especially when using :mod:dataclasses as type metadata.
Patch by Adam Turner.!autolink.
Patch by Adam Turner.html_sidebars
values to a list.
Log an error message when string values are detected.
Patch by Adam Turner.seealso and other "light" admonitions
now break PDF builds if they contain a :dudir:figure directive; and also
if they are contained in a table cell (rendered by tabulary).
Patch by Jean-François B.source_suffix values
with extensions that register parsers.
Patch by Adam Turner.heading-level is used.
Patch by Adam Turner.typing.ParamSpec in autodoc.
Patch by Adam Turner.xcolor package is now required (but is for example part of
Ubuntu texlive-latex-recommended which has always been required).fontawesome5 LaTeX package is needed for the default choices
of icons now used in admonition titles in PDF output; but if unavailable the
PDF build will simply silently omit rendering such icons. Check the
documentation of the iconpackage key of :ref:'sphinxsetup' <latexsphinxsetup> for more.sphinxlightbox environment is not used anymore, all types
of admonitions use (by default) only sphinxheavybox... rst-class:: compact
#11165: Support the officially recommended_ .jinja suffix for template
files.
Patch by James Addison and Adam Turner
.. _officially recommended: https://jinja.palletsprojects.com/en/latest/templates/#template-file-extension
#12325: Flatten Union[Literal[T], Literal[U], ...] to Literal[T, U, ...]
when turning annotations into strings.
Patch by Adam Turner.
#12319: sphinx.ext.extlinks: Add extlink-{name} CSS class to links.
Patch by Hugo van Kemenade.
#12387: Improve CLI progress message, when copying assets. Patch by INADA Nakoi and Bénédikt Tran.
#12361: Add :attr:.BuildEnvironment.parser.
Patch by Chris Sewell.
#12358: Add :attr:.Sphinx.fresh_env_used.
Patch by Chris Sewell.
#12329: Add detection of ambiguous std:label and std:term references during
loading and resolution of Intersphinx targets.
Patch by James Addison.
#12422: Do not duplicate "navigation" in aria-label of built-in themes. Patch by Thomas Weißschuh
#12421: Include project name in logo_alt of built-in themes.
Patch by Thomas Weißschuh
#12448: Add :option:sphinx-apidoc --remove-old option.
Patch by Chris Sewell.
#12456: Add :option:sphinx-autogen --remove-old option.
Patch by Chris Sewell.
#12479: Add warning subtype toc.no_title.
Patch by Ondřej Navrátil.
#12492: Add helper methods for parsing reStructuredText content into nodes from within a directive.
~sphinx.util.docutils.SphinxDirective.parse_content_to_nodes()
parses the directive's content and returns a list of Docutils nodes.~sphinx.util.docutils.SphinxDirective.parse_text_to_nodes()
parses the provided text and returns a list of Docutils nodes.~sphinx.util.docutils.SphinxDirective.parse_inline()
parses the provided text into inline elements and text nodes.Patch by Adam Turner.
#12258: Support typing_extensions.Unpack
Patch by Bénédikt Tran and Adam Turner.
#12524: Add a class option to the :rst:dir:toctree directive.
Patch by Tim Hoffmann.
#12536: Add the :rst:dir:confval directive.
Patch by Adam Turner.
#12537: :confval:c_id_attributes, :confval:c_paren_attributes,
:confval:cpp_id_attributes, and :confval:cpp_paren_attributes
can now be a tuple of strings.
:confval:c_extra_keywords, :confval:gettext_additional_targets,
:confval:html_domain_indices, :confval:latex_domain_indices,
and :confval:texinfo_domain_indices,
can now be a set of strings.
Patch by Adam Turner.
#12523: Added configuration option, :confval:math_numsep, to define the
separator for math numbering.
Patch by Thomas Fanning
#11592: Add :confval:coverage_modules to the coverage builder
to allow explicitly specifying which modules should be documented.
Patch by Stephen Finucane.
#7896, #11989: Add a :rst:dir:py:type directive for documenting type aliases,
and a :rst:role:py:type role for linking to them.
Patch by Ashley Whetter.
#12549: Add optional description argument to
:meth:.Sphinx.add_config_value.
Patch by Chris Sewell.
#6792: Prohibit module import cycles in :mod:sphinx.ext.autosummary.
Patch by Trevor Bekolay.
#12508: LaTeX: Revamped styling of all admonitions, with addition of a title row with icon. Patch by Jean-François B.
#11773: Display :py:class:~typing.Annotated annotations
with their metadata in the Python domain.
Patch by Adam Turner and David Stansby.
#12506: Add heading-level option to :rst:dir:rubric directive.
Patch by Chris Sewell.
#12567: Add the :event:write-started event.
Patch by Chris Sewell.
collections.abc.Callable in annotations.
Patch by Adam Turner.merge_domaindata() in sphinx.ext.duration.
Patch by Matthias Geier.Page N when N is already
the current page number.
Patch by Jean-François B.'lualatex' as :confval:latex_engine
use babel as with 'xelatex' (and not polyglossia).
Patch by Jean-François B.todolist produce correct hyperlinks
in PDF.
Patch by Jean-François B.en locale.
Patch by Nicolas Peugnet.linkcheck_rate_limit_timeout
configuration setting.
Patch by James Addison.695 formatting for LaTeX output.
Patch by Bénédikt Tran.