Bump sphinx from 7.4.7 to 8.1.0 in /docs

[dependabot[bot]]

Bumps sphinx from 7.4.7 to 8.1.0.

Release notes

Sourced from sphinx's releases.

Sphinx 8.1.0

Changelog: https://www.sphinx-doc.org/en/master/changes.html

Sphinx 8.0.2

Changelog: https://www.sphinx-doc.org/en/master/changes.html

Sphinx 8.0.1

Changelog: https://www.sphinx-doc.org/en/master/changes.html

Sphinx 8.0.0

Changelog: https://www.sphinx-doc.org/en/master/changes.html

Dependencies

• #12633: Drop Python 3.9 support.

Incompatible changes

• Remove deprecated functions from sphinx.util:

  • Removed sphinx.util.path_stabilize (use sphinx.util.osutil.path_stabilize).
  • Removed sphinx.util.display_chunk (use sphinx.util.display.display_chunk).
  • Removed sphinx.util.status_iterator (use sphinx.util.display.status_iterator).
  • Removed sphinx.util.SkipProgressMessage (use sphinx.util.display.SkipProgressMessage).
  • Removed sphinx.util.progress_message (use sphinx.util.display.progress_message).
  • Removed sphinx.util.epoch_to_rfc1123 (use sphinx.http_date.epoch_to_rfc1123).
  • Removed sphinx.util.rfc1123_to_epoch (use sphinx.http_date.rfc1123_to_epoch).
  • Removed sphinx.util.save_traceback (use sphinx.exceptions.save_traceback).
  • Removed sphinx.util.format_exception_cut_frames (use sphinx.exceptions.format_exception_cut_frames).
  • Removed sphinx.util.xmlname_checker (use sphinx.builders.epub3._XML_NAME_PATTERN).

  Patch by Adam Turner.

• Removed sphinx.util.osutil.cd (use contextlib.chdir). Patch by Adam Turner.

• Removed sphinx.util.typing.stringify (use sphinx.util.typing.stringify_annotation). Patch by Adam Turner.

... (truncated)

Changelog

Sourced from sphinx's changelog.

Release 8.1.0 (released Oct 10, 2024)

Dependencies

• #12756: Add lower-bounds to the sphinxcontrib-* dependencies. Patch by Adam Turner.
• #12833: Update the LaTeX parskip package from 2001 to 2018. Patch by Jean-François B.

Incompatible changes

• #12763: Remove unused internal class sphinx.util.Tee. Patch by Adam Turner.
• #12822: LaTeX: for Unicode engines, the :ref:fvset default is changed to '\\fvset{fontsize=auto}' from '\\fvset{fontsize=\\small}'. Code-blocks are unchanged as FreeMono is now loaded with Scale=0.9. An adjustment to existing projects is needed only if they used a custom :ref:fontpkg configuration and did not set :ref:fvset. Patch by Jean-François B.
• #12875: Disable smartquotes for languages: zh_CN and zh_TW by default. Patch by A. Rafey Khan.

Deprecated

• #12762: Deprecate sphinx.util.import_object. Use :py:func:importlib.import_module instead. Patch by Adam Turner.
• #12766: Deprecate sphinx.util.FilenameUniqDict and sphinx.util.DownloadFiles. Patch by Adam Turner.

Features added

• #11328: Mention evaluation of templated content during production of static output files. Patch by James Addison.
• #12704: LaTeX: make :dudir:contents <table-of-contents>, :dudir:topic, and :dudir:sidebar directives separately customizable for PDF output. Patch by Jean-François B. and Bénédikt Tran.
• #12474: Support type-dependent search result highlighting via CSS. Patch by Tim Hoffmann.
• #12652: LaTeX: Add :confval:math_numsep support to latex builder. Patch by Thomas Fanning and Jean-François B.
• #12743: No longer exit on the first warning when :option:--fail-on-warning <sphinx-build --fail-on-warning> is used.

... (truncated)

Commits

• 2f1d775 Bump to 8.1.0 final
• 668bb03 Partially revert "Update message catalogues (#12770)"
• 4f94cc6 [bot]: Update message catalogues (#12770)
• 283d863 Minor cleanup to autosectionlabel docs (#12992)
• 566d1cd Reword a paragraph in latex_table_style's documentation (#12994)
• fac1651 Bump pyright to 1.1.384 (#12990)
• d135d2e Mark Builder.write() as final (#12767)
• 705d5dd Convert latin_terms to a set (#12995)
• dcd276d Extract _feed_visit_nodes
• c87b758 Fix tests for Python 3.12.7 (#12993)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot merge` will merge this PR after your CI passes on it - `@dependabot squash and merge` will squash and merge this PR after your CI passes on it - `@dependabot cancel merge` will cancel a previously requested merge and block automerging - `@dependabot reopen` will reopen this PR if it is closed - `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - `@dependabot show ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[dependabot[bot]]

Superseded by #1351.