Python documentation generator

Edit Package python-Sphinx

Sphinx is a tool that makes it easy to create intelligent and beautiful
documentation for Python projects (or other documents consisting of multiple
reStructuredText sources), written by Georg Brandl. It was originally created
for the new Python documentation, and has excellent facilities for Python
project documentation, but C/C++ is supported as well, and more languages are
planned.

Sphinx uses reStructuredText as its markup language, and many of its strengths
come from the power and straightforwardness of reStructuredText and its parsing
and translating suite, the Docutils.

Refresh
Refresh
Source Files
Filename Size Changed
Sphinx-4.4.0.tar.gz 0006690021 6.38 MB
Sphinx-4.4.0.tar.gz.asc 0000000833 833 Bytes
_multibuild 0000000053 53 Bytes
python-Sphinx.changes 0000143874 141 KB
python-Sphinx.spec 0000011893 11.6 KB
python3.inv 0000112797 110 KB
readthedocs.inv 0000019635 19.2 KB
requests.inv 0000002059 2.01 KB
Revision 84 (latest revision is 105)
Dominique Leuenberger's avatar Dominique Leuenberger (dimstar_suse) accepted request 947727 from Matej Cepl's avatar Matej Cepl (mcepl) (revision 84)
- Fix missing install_requires dependencies.
- I know it looks cool to have URLs for all Source files, but these are
  files in VCS and they are inherently very unstable, so it breaks our
  checks.
- Update to version 4.4.0:
  * #10007: Use ``importlib_metadata`` for python-3.9 or older
  * #10007: Drop ``setuptools``
  * #9075: autodoc: Add a config variable :confval:`autodoc_typehints_format`
    to suppress the leading module names of typehints of function signatures (ex.
    ``io.StringIO`` -> ``StringIO``)
  * #9831: Autosummary now documents only the members specified in a module's
    ``__all__`` attribute if :confval:`autosummary_ignore_module_all` is set to
    ``False``. The default behaviour is unchanged. Autogen also now supports
    this behavior with the ``--respect-module-all`` switch.
  * #9555: autosummary: Improve error messages on failure to load target object
  * #9800: extlinks: Emit warning if a hardcoded link is replaceable
    by an extlink, suggesting a replacement.
  * #9961: html: Support nested <kbd> HTML elements in other HTML builders
  * #10013: html: Allow to change the loading method of JS via ``loading_method``
    parameter for :meth:`Sphinx.add_js_file()`
  * #9551: html search: "Hide Search Matches" link removes "highlight" parameter
    from URL
  * #9815: html theme: Wrap sidebar components in div to allow customizing their
    layout via CSS
  * #9827: i18n: Sort items in glossary by translated terms
  * #9899: py domain: Allows to specify cross-reference specifier (``.`` and
    ``~``) as ``:type:`` option
  * #9894: linkcheck: add option ``linkcheck_exclude_documents`` to disable link
    checking in matched documents.
  * #9793: sphinx-build: Allow to use the parallel build feature in macOS on macOS
    and Python3.8+
  * #10055: sphinx-build: Create directories when ``-w`` option given
  * #9993: std domain: Allow to refer an inline target (ex. ``_`target name```)
    via :rst:role:`ref` role
  * #9981: std domain: Strip value part of the option directive from general index
  * #9391: texinfo: improve variable in ``samp`` role
  * #9578: texinfo: Add :confval:`texinfo_cross_references` to disable cross
    references for readability with standalone readers
  * #9822 (and #9062), add new Intersphinx role :rst:role:`external` for explict
    lookup in the external projects, without resolving to the local project.
  * #9866: autodoc: doccomment for the imported class was ignored
  * #9883: autodoc: doccomment for the alias to mocked object was ignored
  * #9908: autodoc: debug message is shown on building document using NewTypes
    with Python 3.10
  * #9968: autodoc: instance variables are not shown if __init__ method has
    position-only-arguments
  * #9194: autodoc: types under the "typing" module are not hyperlinked
  * #10009: autodoc: Crashes if target object raises an error on getting docstring
  * #10058: autosummary: Imported members are not shown when
    ``autodoc_class_signature = 'separated'``
  * #9947: i18n: topic directive having a bullet list can't be translatable
  * #9878: mathjax: MathJax configuration is placed after loading MathJax itself
  * #9932: napoleon: empty "returns" section is generated even if no description
  * #9857: Generated RFC links use outdated base url
  * #9909: HTML, prevent line-wrapping in literal text.
  * #10061: html theme: Configuration values added by themes are not be able to
    override from conf.py
  * #10073: imgconverter: Unnecessary availablity check is called for "data" URIs
  * #9925: LaTeX: prohibit also with ``'xelatex'`` line splitting at dashes of
    inline and parsed literals
  * #9944: LaTeX: extra vertical whitespace for some nested declarations
  * #9940: LaTeX: Multi-function declaration in Python domain has cramped
    vertical spacing in latexpdf output
  * #10015: py domain: types under the "typing" module are not hyperlinked defined
    at info-field-list
  * #9390: texinfo: Do not emit labels inside footnotes
  * #9413: xml: Invalid XML was generated when cross referencing python objects
  * #9979: Error level messages were displayed as warning messages
  * #10057: Failed to scan documents if the project is placed onto the root
    directory
  * #9636: code-block: ``:dedent:`` without argument did strip newlines
- Add new intersphinx mapping file: readthedocs.inv.
- Fix %fdupes.
- Remove python-Sphinx-rpmlintrc as it is not used any more.
Comments 0
openSUSE Build Service is sponsored by