You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The app argument of sphinx.environment.BuildEnvironment becomes
required
sphinx.application.Sphinx.html_theme
sphinx.ext.autosummary._app
sphinx.util.docstrings.extract_metadata()
Features added
#8107: autodoc: Add class-doc-from option to :rst:dir:autoclass
directive to control the content of the specific class like
:confval:autoclass_content
#8588: autodoc: :confval:autodoc_type_aliases now supports dotted name. It
allows you to define an alias for a class with module name like foo.bar.BazClass
#9175: autodoc: Special member is not documented in the module
#9195: autodoc: The arguments of typing.Literal are wrongly rendered
#9185: autodoc: :confval:autodoc_typehints allows 'both' setting to
allow typehints to be included both in the signature and description
#4257: autodoc: Add :confval:autodoc_class_signature to separate the class
entry and the definition of __init__() method
#8061, #9218: autodoc: Support variable comment for alias classes
#3014: autodoc: Add :event:autodoc-process-bases to modify the base classes
of the class definitions
#9272: autodoc: Render enum values for the default argument value better
#9384: autodoc: autodoc_typehints='none' now erases typehints for
variables, attributes and properties
#3257: autosummary: Support instance attributes for classes
#9358: html: Add "heading" role to the toctree items
#9225: html: Add span tag to the return typehint of method/function
#9129: html search: Show search summaries when html_copy_source = False
#9307: html search: Prevent corrections and completions in search field
#9120: html theme: Eliminate prompt characters of code-block from copyable
text
#9176: i18n: Emit a debug message if message catalog file not found under
:confval:locale_dirs
#9414: LaTeX: Add xeCJKVerbAddon to default fvset config for Chinese documents
#9016: linkcheck: Support checking anchors on github.com
#9016: linkcheck: Add a new event :event:linkcheck-process-uri to modify
URIs before checking hyperlinks
#6525: linkcheck: Add :confval:linkcheck_allowed_redirects to mark
hyperlinks that are redirected to expected URLs as "working"
#1874: py domain: Support union types using | in info-field-list
#9268: py domain: :confval:python_use_unqualified_type_names supports type
field in info-field-list
#9131: Add :confval:nitpick_ignore_regex to ignore nitpicky warnings using
regular expressions
#9174: Add Sphinx.set_html_assets_policy to tell extensions to include
HTML assets in all the pages. Extensions can check this via Sphinx.registry.html_assets_policy
C++, add support for
inline variables,
consteval functions,
constinit variables,
char8_t,
explicit(<constant expression>) specifier,
digit separators in literals, and
constraints in placeholder type specifiers, aka. adjective syntax
(e.g., Sortable auto &v).
Support docutils-0.17. Please notice it changes the output of HTML builder.
Some themes do not support it, and you need to update your custom CSS to
upgrade it.
Incompatible changes
4.0.0b1
#8539: autodoc: info-field-list is generated into the class description when autodoc_typehints='description' and autoclass_content='class' set
#8898: extlinks: "%s" becomes required keyword in the link caption string
domain: The Index class becomes subclasses of abc.ABC to indicate
methods that must be overridden in the concrete classes
#4826: py domain: The structure of python objects is changed. A boolean value
is added to indicate that the python object is canonical one
#7425: MathJax: The MathJax was changed from 2 to 3. Users using a custom
MathJax configuration may have to set the old MathJax path or update their
configuration for version 3. See :mod:sphinx.ext.mathjax.
#7784: i18n: The msgid for alt text of image is changed
#5560: napoleon: :confval:napoleon_use_param also affect "other parameters"
section
#7996: manpage: Make a section directory on build manpage by default (see
:confval:man_make_section_directory)
#7849: html: Change the default setting of
:confval:html_codeblock_linenos_style to 'inline'
#8380: html search: search results are wrapped with <p> instead of <div>
html theme: Move a script tag for documentation_options.js in
basic/layout.html to script_files variable
html theme: Move CSS tags in basic/layout.html to css_files variable
#8915: html theme: Emit a warning for sphinx_rtd_theme-0.2.4 or older
#8508: LaTeX: uplatex becomes a default setting of latex_engine for Japanese
documents
#5977: py domain: :var:, :cvar: and :ivar: fields do not create
cross-references
#4550: The align attribute of figure and table nodes becomes None by default instead of 'default'
#8769: LaTeX refactoring: split sphinx.sty into multiple files and rename
some auxiliary files created in latex build output repertory
#4826: py domain: Add :canonical: option to python directives to describe
the location where the object is defined
#7199: py domain: Add :confval:python_use_unqualified_type_names to suppress
the module name of the python reference if it can be resolved (experimental)
#7068: py domain: Add :rst:dir:py:property directive to describe a property
#7784: i18n: The alt text for image is translated by default (without
:confval:gettext_additional_targets setting)
#2018: html: :confval:html_favicon and :confval:html_logo now accept URL
for the image
#8070: html search: Support searching for 2characters word
#9036: html theme: Allow to inherite the search page
#8938: imgconverter: Show the error of the command availability check
#7830: Add debug logs for change detection of sources and templates
#8201: Emit a warning if toctree contains duplicated entries
#8326: master_doc is now renamed to :confval:root_doc
#8942: C++, add support for the C++20 spaceship operator, <=>.
#7199: A new node, sphinx.addnodes.pending_xref_condition has been added.
It can be used to choose appropriate content of the reference by conditions.
4.0.0b2
#8818: autodoc: Super class having Any arguments causes nit-picky warning
#9095: autodoc: TypeError is raised on processing broken metaclass
#9110: autodoc: metadata of GenericAlias is not rendered as a reference in
py37+
#9098: html: copy-range protection for doctests doesn't work in Safari
#9103: LaTeX: imgconverter: conversion runs even if not needed
#8127: py domain: Ellipsis in info-field-list causes nit-picky warning
#9121: py domain: duplicated warning is emitted when both canonical and its
alias objects are defined on the document
#9023: More CSS classes on domain descriptions, see :ref:nodes for details.
#8195: mathjax: Rename :confval:mathjax_config to
:confval:mathjax2_config and add :confval:mathjax3_config
Bugs fixed
4.0.0b1
#8917: autodoc: Raises a warning if function has wrong globals value
#8415: autodoc: a TypeVar imported from other module is not resolved (in
Python 3.7 or above)
#8992: autodoc: Failed to resolve types.TracebackType type annotation
#8905: html: html_add_permalinks=None and html_add_permalinks="" are ignored
#8380: html search: Paragraphs in search results are not identified as <p>
#8915: html theme: The translation of sphinx_rtd_theme does not work
#8342: Emit a warning if a unknown domain is given for directive or role (ex. :unknown:doc:)
#8711: LaTeX: backticks in code-blocks trigger latexpdf build warning (and font
change) with late TeXLive 2019
#8253: LaTeX: Figures with no size defined get overscaled (compared to images
with size explicitly set in pixels) (fixed for 'pdflatex'/'lualatex' only)
#8881: LaTeX: The depth of bookmarks panel in PDF is not enough for navigation
#8874: LaTeX: the fix to two minor Pygments LaTeXFormatter output issues ignore
Pygments style
#8925: LaTeX: 3.5.0 verbatimmaxunderfull setting does not work as
expected
@nejch Nice job noticing. If a new theme will fix the problem it sounds reasonable to me.
It's really a minor thing, but I might have a look on the weekend just for fun :) I've looked at Furo before (where I don't like that there's no dark/light toggle as the dark mode doesn't work that well for code snippets IMO pradyunsg/furo#24) and sphinx-material which is also nice and looks familiar to people using mkdocs. (both are pretty much drop-in replacements with a one line change)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
==3.5.4->==4.2.0Release Notes
sphinx-doc/sphinx
v4.2.0Compare Source
=====================================
Features added
3.10 or above
template variable
sphinx_version_tuple:py:property:directive supports:classmethod:option to describe the class property
builddiras an argumentBugs fixed
namespace package
class inherites the class having
_nameattributetypingmodule are not displayedwell with the HEAD of 3.10
__init__()and
__new__()list[int])are not displayed well
are not removed completely
failed to fetch the content of the page
:type:option for :rst:dir:py:propertydirective doesnot create a hyperlink
function pointers.
language-highlighted
:code:role.v4.1.2Compare Source
=====================================
Incompatible changes
github.com (ex. anchors in reST/Markdown documents)
Bugs fixed
typing.NewTypeare not displayed wellwith the HEAD of 3.10
typingmodule are not displayed wellwith the HEAD of 3.10
autodoc_class_signature = "separated"v4.1.1Compare Source
=====================================
Dependencies
Bugs fixed
v4.1.0Compare Source
=====================================
Dependencies
Deprecated
appargument ofsphinx.environment.BuildEnvironmentbecomesrequired
sphinx.application.Sphinx.html_themesphinx.ext.autosummary._appsphinx.util.docstrings.extract_metadata()Features added
#8107: autodoc: Add
class-doc-fromoption to :rst:dir:autoclassdirective to control the content of the specific class like
:confval:
autoclass_content#8588: autodoc: :confval:
autodoc_type_aliasesnow supports dotted name. Itallows you to define an alias for a class with module name like
foo.bar.BazClass#9175: autodoc: Special member is not documented in the module
#9195: autodoc: The arguments of
typing.Literalare wrongly rendered#9185: autodoc: :confval:
autodoc_typehintsallows'both'setting toallow typehints to be included both in the signature and description
#4257: autodoc: Add :confval:
autodoc_class_signatureto separate the classentry and the definition of
__init__()method#8061, #9218: autodoc: Support variable comment for alias classes
#3014: autodoc: Add :event:
autodoc-process-basesto modify the base classesof the class definitions
#9272: autodoc: Render enum values for the default argument value better
#9384: autodoc:
autodoc_typehints='none'now erases typehints forvariables, attributes and properties
#3257: autosummary: Support instance attributes for classes
#9358: html: Add "heading" role to the toctree items
#9225: html: Add span tag to the return typehint of method/function
#9129: html search: Show search summaries when html_copy_source = False
#9307: html search: Prevent corrections and completions in search field
#9120: html theme: Eliminate prompt characters of code-block from copyable
text
#9176: i18n: Emit a debug message if message catalog file not found under
:confval:
locale_dirs#9414: LaTeX: Add xeCJKVerbAddon to default fvset config for Chinese documents
#9016: linkcheck: Support checking anchors on github.com
#9016: linkcheck: Add a new event :event:
linkcheck-process-urito modifyURIs before checking hyperlinks
#6525: linkcheck: Add :confval:
linkcheck_allowed_redirectsto markhyperlinks that are redirected to expected URLs as "working"
#1874: py domain: Support union types using
|in info-field-list#9268: py domain: :confval:
python_use_unqualified_type_namessupports typefield in info-field-list
#9097: Optimize the parallel build
#9131: Add :confval:
nitpick_ignore_regexto ignore nitpicky warnings usingregular expressions
#9174: Add
Sphinx.set_html_assets_policyto tell extensions to includeHTML assets in all the pages. Extensions can check this via
Sphinx.registry.html_assets_policyC++, add support for
inlinevariables,constevalfunctions,constinitvariables,char8_t,explicit(<constant expression>)specifier,(e.g.,
Sortable auto &v).C, add support for digit separators in literals.
#9166: LaTeX: support containers in LaTeX output
Bugs fixed
undocumented
attribute not having any comment
rendered
class) via autoclass directive
:confval:
man_make_section_directoryis not correcton HEAD request
(e.g.
Callable[[], None])will be rendered with a bracket missing(
Callable[], None]):param:and:type:fields does not support a type containingwhitespace (ex.
Dict[str, str])making an single xref. For C and C++, use the
exprrole for typed fields.v4.0.3Compare Source
=====================================
Features added
_Decimal32,_Decimal64, and_Decimal128.c_extra_keywordsto allow user-defined keywordsduring parsing.
sphinx.util:force_decode()to become some 3rd partyextensions available again during 5.0
Bugs fixed
versionchangedwith contents being a listwill cause error during pdf build
with Japanese engines
See also :confval:
c_extra_keywords.v4.0.2Compare Source
=====================================
Dependencies
Incompatible changes
(see :confval:
man_make_section_directory)Bugs fixed
that does not support the node installs a missing-reference handler
v4.0.1Compare Source
=====================================
Bugs fixed
from a property of the class
autosummary_generate
cross-reference" warning
v4.0.0Compare Source
=====================================
Dependencies
4.0.0b1
tex-gyrefont dependency4.0.0b2
Some themes do not support it, and you need to update your custom CSS to
upgrade it.
Incompatible changes
4.0.0b1
autodoc_typehints='description'andautoclass_content='class'setIndexclass becomes subclasses ofabc.ABCto indicatemethods that must be overridden in the concrete classes
is added to indicate that the python object is canonical one
MathJax configuration may have to set the old MathJax path or update their
configuration for version 3. See :mod:
sphinx.ext.mathjax.napoleon_use_paramalso affect "other parameters"section
:confval:
man_make_section_directory):confval:
html_codeblock_linenos_styleto'inline'<p>instead of<div>basic/layout.html to
script_filesvariablecss_filesvariabledocuments
:var:,:cvar:and:ivar:fields do not createcross-references
alignattribute offigureandtablenodes becomesNoneby default instead of'default'some auxiliary files created in
latexbuild output repertorypath as a relative path from source directory
4.0.0b2
cpp:exprand:rst:role:
cpp:texpr.Deprecated
html_codeblock_linenos_stylefaviconandlogovariable in HTML templatessphinx.directives.patches.CSVTablesphinx.directives.patches.ListTablesphinx.directives.patches.RSTTablesphinx.ext.autodoc.directive.DocumenterBridge.filename_setsphinx.ext.autodoc.directive.DocumenterBridge.warn()sphinx.registry.SphinxComponentRegistry.get_source_input()sphinx.registry.SphinxComponentRegistry.source_inputssphinx.transforms.FigureAlignersphinx.util.pycompat.convert_with_2to3()sphinx.util.pycompat.execfile_()sphinx.util.smartypantssphinx.util.typing.DirectiveOptionFeatures added
4.0.0b1
boundargument for TypeVarwhen the class has two different names; a canonical name and an alias name
autodoc_typehints_description_targetto controlthe behavior of
autodoc_typehints=descriptionautodoc_docstring_signaturewill continue to lookfor multiple signature lines without backslash character
autosummary_generateby default:canonical:option to python directives to describethe location where the object is defined
python_use_unqualified_type_namesto suppressthe module name of the python reference if it can be resolved (experimental)
py:propertydirective to describe a property:confval:
gettext_additional_targetssetting)html_faviconand :confval:html_logonow accept URLfor the image
master_docis now renamed to :confval:root_doc<=>.sphinx.addnodes.pending_xref_conditionhas been added.It can be used to choose appropriate content of the reference by conditions.
4.0.0b2
Anyarguments causes nit-picky warningpy37+
alias objects are defined on the document
nodesfor details.mathjax_configto:confval:
mathjax2_configand add :confval:mathjax3_configBugs fixed
4.0.0b1
Python 3.7 or above)
<p>:unknown:doc:)cpp:enumeratorchange) with late TeXLive 2019
with size explicitly set in pixels) (fixed for
'pdflatex'/'lualatex'only)Pygments style
verbatimmaxunderfullsetting does not work asexpected
\pysigline\pysiglinewithargsretdoes not compute correctlyavailable horizontal space and should use a ragged right style
:confval:
cpp_index_common_prefixinstead of the first that matches.as parameter name.
function parameter lists.
(function) declarators, and in the argument to
sizeof....4.0.0b2
KeyErrorwhen analiasdirective is the first C/C++directive in a file with another C/C++ directive later.
4.0.0b3
Configuration
📅 Schedule: At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by WhiteSource Renovate. View repository job log here.