summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAdam Turner <9087854+aa-turner@users.noreply.github.com>2022-07-10 23:05:23 +0100
committerAdam Turner <9087854+aa-turner@users.noreply.github.com>2022-07-10 23:05:23 +0100
commit1e3ade55fe24107c883fc2725ecab28350e3f6cb (patch)
tree22ccd94149d763d857a2ef48c79efc0df91675f2
parent3d175d9a2423e52e549f003700abb42c7a9db21f (diff)
parent9112cfeb8d7489e5878ab15b4cc13796fba99d69 (diff)
downloadsphinx-git-1e3ade55fe24107c883fc2725ecab28350e3f6cb.tar.gz
Merge branch '5.x'
-rw-r--r--.github/workflows/main.yml2
-rw-r--r--CHANGES26
-rw-r--r--doc/_static/pocoo.pngbin1498 -> 0 bytes
-rw-r--r--doc/_templates/contents.html6
-rw-r--r--doc/_templates/index.html129
-rw-r--r--doc/_templates/indexsidebar.html23
-rw-r--r--doc/_themes/sphinx13/layout.html107
-rw-r--r--doc/_themes/sphinx13/static/bodybg.pngbin429 -> 0 bytes
-rw-r--r--doc/_themes/sphinx13/static/footerbg.pngbin180 -> 0 bytes
-rw-r--r--doc/_themes/sphinx13/static/headerbg.pngbin189 -> 0 bytes
-rw-r--r--doc/_themes/sphinx13/static/listitem.pngbin149 -> 0 bytes
-rw-r--r--doc/_themes/sphinx13/static/relbg.pngbin183 -> 0 bytes
-rw-r--r--doc/_themes/sphinx13/static/sphinx13.css220
-rw-r--r--doc/_themes/sphinx13/theme.conf2
-rw-r--r--doc/conf.py29
-rw-r--r--doc/contents.rst39
-rw-r--r--doc/index.rst101
-rw-r--r--doc/latex.rst45
-rw-r--r--doc/tutorial/end.rst4
-rw-r--r--sphinx/application.py4
-rw-r--r--sphinx/cmd/build.py3
-rw-r--r--sphinx/events.py3
-rw-r--r--sphinx/locale/ar/LC_MESSAGES/sphinx.mobin7947 -> 7947 bytes
-rw-r--r--sphinx/locale/ar/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/bg/LC_MESSAGES/sphinx.mobin492 -> 492 bytes
-rw-r--r--sphinx/locale/bg/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/bn/LC_MESSAGES/sphinx.mobin7976 -> 7976 bytes
-rw-r--r--sphinx/locale/bn/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/ca/LC_MESSAGES/sphinx.mobin5587 -> 5587 bytes
-rw-r--r--sphinx/locale/ca/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/cak/LC_MESSAGES/sphinx.mobin2424 -> 2424 bytes
-rw-r--r--sphinx/locale/cak/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/cs/LC_MESSAGES/sphinx.mobin8265 -> 8265 bytes
-rw-r--r--sphinx/locale/cs/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/cy/LC_MESSAGES/sphinx.mobin6214 -> 6214 bytes
-rw-r--r--sphinx/locale/cy/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/da/LC_MESSAGES/sphinx.mobin13160 -> 13160 bytes
-rw-r--r--sphinx/locale/da/LC_MESSAGES/sphinx.po10
-rw-r--r--sphinx/locale/de/LC_MESSAGES/sphinx.mobin11216 -> 11216 bytes
-rw-r--r--sphinx/locale/de/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/el/LC_MESSAGES/sphinx.mobin82273 -> 82273 bytes
-rw-r--r--sphinx/locale/el/LC_MESSAGES/sphinx.po10
-rw-r--r--sphinx/locale/en_FR/LC_MESSAGES/sphinx.mobin462 -> 462 bytes
-rw-r--r--sphinx/locale/en_FR/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/en_GB/LC_MESSAGES/sphinx.mobin14119 -> 14119 bytes
-rw-r--r--sphinx/locale/en_GB/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/en_HK/LC_MESSAGES/sphinx.mobin508 -> 508 bytes
-rw-r--r--sphinx/locale/en_HK/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/eo/LC_MESSAGES/sphinx.mobin1864 -> 1864 bytes
-rw-r--r--sphinx/locale/eo/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/es/LC_MESSAGES/sphinx.mobin83320 -> 83320 bytes
-rw-r--r--sphinx/locale/es/LC_MESSAGES/sphinx.po10
-rw-r--r--sphinx/locale/et/LC_MESSAGES/sphinx.mobin33773 -> 33773 bytes
-rw-r--r--sphinx/locale/et/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/eu/LC_MESSAGES/sphinx.mobin6727 -> 6727 bytes
-rw-r--r--sphinx/locale/eu/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/fa/LC_MESSAGES/sphinx.mobin99682 -> 99682 bytes
-rw-r--r--sphinx/locale/fa/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/fi/LC_MESSAGES/sphinx.mobin2912 -> 2912 bytes
-rw-r--r--sphinx/locale/fi/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/fr/LC_MESSAGES/sphinx.mobin85471 -> 85471 bytes
-rw-r--r--sphinx/locale/fr/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mobin555 -> 555 bytes
-rw-r--r--sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/he/LC_MESSAGES/sphinx.mobin4947 -> 4947 bytes
-rw-r--r--sphinx/locale/he/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/hi/LC_MESSAGES/sphinx.mobin98870 -> 98870 bytes
-rw-r--r--sphinx/locale/hi/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mobin502 -> 502 bytes
-rw-r--r--sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/hr/LC_MESSAGES/sphinx.mobin17189 -> 17189 bytes
-rw-r--r--sphinx/locale/hr/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/hu/LC_MESSAGES/sphinx.mobin11533 -> 11533 bytes
-rw-r--r--sphinx/locale/hu/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/id/LC_MESSAGES/sphinx.mobin60797 -> 60797 bytes
-rw-r--r--sphinx/locale/id/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/is/LC_MESSAGES/sphinx.mobin3082 -> 3082 bytes
-rw-r--r--sphinx/locale/is/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/it/LC_MESSAGES/sphinx.mobin10819 -> 10819 bytes
-rw-r--r--sphinx/locale/it/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/ja/LC_MESSAGES/sphinx.mobin84968 -> 87918 bytes
-rw-r--r--sphinx/locale/ja/LC_MESSAGES/sphinx.po26
-rw-r--r--sphinx/locale/ko/LC_MESSAGES/sphinx.mobin85235 -> 85235 bytes
-rw-r--r--sphinx/locale/ko/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/lt/LC_MESSAGES/sphinx.mobin7104 -> 7104 bytes
-rw-r--r--sphinx/locale/lt/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/lv/LC_MESSAGES/sphinx.mobin6786 -> 6786 bytes
-rw-r--r--sphinx/locale/lv/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/mk/LC_MESSAGES/sphinx.mobin2011 -> 2011 bytes
-rw-r--r--sphinx/locale/mk/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mobin6766 -> 6766 bytes
-rw-r--r--sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/ne/LC_MESSAGES/sphinx.mobin8869 -> 8869 bytes
-rw-r--r--sphinx/locale/ne/LC_MESSAGES/sphinx.po10
-rw-r--r--sphinx/locale/nl/LC_MESSAGES/sphinx.mobin19426 -> 19426 bytes
-rw-r--r--sphinx/locale/nl/LC_MESSAGES/sphinx.po10
-rw-r--r--sphinx/locale/pl/LC_MESSAGES/sphinx.mobin29703 -> 29703 bytes
-rw-r--r--sphinx/locale/pl/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/pt/LC_MESSAGES/sphinx.mobin544 -> 544 bytes
-rw-r--r--sphinx/locale/pt/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mobin81410 -> 81410 bytes
-rw-r--r--sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mobin8035 -> 8035 bytes
-rw-r--r--sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po10
-rw-r--r--sphinx/locale/ro/LC_MESSAGES/sphinx.mobin8822 -> 8822 bytes
-rw-r--r--sphinx/locale/ro/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/ru/LC_MESSAGES/sphinx.mobin16427 -> 16427 bytes
-rw-r--r--sphinx/locale/ru/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/si/LC_MESSAGES/sphinx.mobin3602 -> 3602 bytes
-rw-r--r--sphinx/locale/si/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/sk/LC_MESSAGES/sphinx.mobin68247 -> 68247 bytes
-rw-r--r--sphinx/locale/sk/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/sl/LC_MESSAGES/sphinx.mobin5417 -> 5417 bytes
-rw-r--r--sphinx/locale/sl/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/sphinx.pot6
-rw-r--r--sphinx/locale/sq/LC_MESSAGES/sphinx.mobin79913 -> 79913 bytes
-rw-r--r--sphinx/locale/sq/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/sr/LC_MESSAGES/sphinx.mobin9426 -> 9426 bytes
-rw-r--r--sphinx/locale/sr/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mobin584 -> 584 bytes
-rw-r--r--sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mobin579 -> 579 bytes
-rw-r--r--sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/sv/LC_MESSAGES/sphinx.mobin6754 -> 6754 bytes
-rw-r--r--sphinx/locale/sv/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/ta/LC_MESSAGES/sphinx.mobin647 -> 647 bytes
-rw-r--r--sphinx/locale/ta/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/te/LC_MESSAGES/sphinx.mobin489 -> 489 bytes
-rw-r--r--sphinx/locale/te/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/tr/LC_MESSAGES/sphinx.mobin58341 -> 58341 bytes
-rw-r--r--sphinx/locale/tr/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mobin6693 -> 6693 bytes
-rw-r--r--sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/ur/LC_MESSAGES/sphinx.mobin487 -> 487 bytes
-rw-r--r--sphinx/locale/ur/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/vi/LC_MESSAGES/sphinx.mobin5971 -> 5971 bytes
-rw-r--r--sphinx/locale/vi/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/yue/LC_MESSAGES/sphinx.mobin487 -> 487 bytes
-rw-r--r--sphinx/locale/yue/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mobin76829 -> 76829 bytes
-rw-r--r--sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po8
-rw-r--r--sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mobin501 -> 501 bytes
-rw-r--r--sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mobin516 -> 516 bytes
-rw-r--r--sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mobin76189 -> 76189 bytes
-rw-r--r--sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po6
-rw-r--r--sphinx/texinputs/sphinx.sty10
-rw-r--r--sphinx/texinputs/sphinxlatexliterals.sty166
-rw-r--r--sphinx/texinputs/sphinxpackageboxes.sty116
-rw-r--r--sphinx/themes/basic/static/basic.css_t16
-rw-r--r--sphinx/util/docutils.py39
-rw-r--r--sphinx/writers/latex.py6
-rw-r--r--tests/test_events.py23
-rw-r--r--tox.ini7
155 files changed, 798 insertions, 766 deletions
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 308f01855..07c4c6511 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -19,7 +19,7 @@ jobs:
- python: "3.10"
docutils: du18
- python: "3.10"
- docutils: du19pre
+ docutils: du19
- python: "3.11-dev"
docutils: py311
diff --git a/CHANGES b/CHANGES
index 31bc0537c..3adffca4f 100644
--- a/CHANGES
+++ b/CHANGES
@@ -49,10 +49,17 @@ Features added
Pradyun Gedam.
* #10619: LaTeX: new ``shadowShadowColor`` and ``shadowBorderColor`` configurations
for :ref:`'sphinxsetup' <latexsphinxsetup>` key of :confval:`latex_elements`
+* #10639: LaTeX: ``verbatimradius`` configuration added to the LaTeX keys of
+ :ref:`'sphinxsetup' <latexsphinxsetup>`. If positive, code-blocks are rendered
+ with rounded corners.
+* #10599: HTML Theme: Wrap consecutive footnotes in an ``<aside>`` element when
+ using Docutils 0.18 or later, to allow for easier styling. This matches the
+ behaviour introduced in Docutils 0.19. Patch by Adam Turner.
Bugs fixed
----------
+* #10634: Make -P (pdb) option work better with exceptions triggered from events
* #10031: py domain: Fix spurious whitespace in unparsing various operators (``+``,
``-``, ``~``, and ``**``). Patch by Adam Turner.
* #10460: logging: Always show node source locations as absolute paths.
@@ -64,6 +71,10 @@ Bugs fixed
* #10633: LaTeX: user injected ``\color`` commands in topic or admonition boxes may
cause color leaks in PDF due to upstream `framed.sty <https://ctan.org/pkg/framed>`_
bug
+* #10638: LaTeX: framed coloured boxes in highlighted code (e.g. highlighted
+ diffs using Pygments style ``'manni'``) inherit thickness of code-block frame
+* #10647: LaTeX: Only one ``\label`` is generated for ``desc_signature`` node
+ even if it has multiple node IDs
* #10579: i18n: UnboundLocalError is raised on translating raw directive
* #9577, #10088: py domain: Fix warning for duplicate Python references when
using ``:any:`` and autodoc.
@@ -316,7 +327,8 @@ Features added
* #10107: i18n: Allow to suppress translation warnings by adding ``#noqa``
comment to the tail of each translation message
* #10252: C++, support attributes on classes, unions, and enums.
-* #10253: :rst:dir:`pep` role now generates URLs based on peps.python.org
+* #10253: :rst:role:`pep` role now generates URLs based on `peps.python.org
+ <https://peps.python.org>`_
Bugs fixed
----------
@@ -338,7 +350,7 @@ Bugs fixed
variables/structure members
* #10175: LaTeX: named footnote reference is linked to an incorrect footnote if
the name is also used in the different document
-* #10269: manpage: Failed to resolve the title of :ref: cross references
+* #10269: manpage: Failed to resolve the title of :rst:role:`ref` cross references
* #10179: i18n: suppress "rST localization" warning
* #10118: imgconverter: Unnecessary availablity check is called for remote URIs
* #10181: napoleon: attributes are displayed like class attributes for google
@@ -370,7 +382,7 @@ Features added
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()`
+ 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
@@ -477,7 +489,7 @@ Incompatible changes
with more docutils nodes to allow better CSS styling.
It may break existing styling.
* #9672: the signature of
- :py:meth:`domains.py.PyObject.get_signature_prefix` has changed to
+ ``domains.python.PyObject.get_signature_prefix`` has changed to
return a list of nodes instead of a plain string.
* #9695: ``domains.js.JSObject.display_prefix`` has been changed into a method
``get_display_prefix`` which now returns a list of nodes
@@ -554,7 +566,7 @@ Bugs fixed
* #9775: py domain: Literal typehint was converted to a cross reference when
:confval:`autodoc_typehints='description'`
* #9708: needs_extension failed to check double-digit version correctly
-* #9688: Fix :rst:dir:`code`` does not recognize ``:class:`` option
+* #9688: Fix Sphinx patched :dudir:`code` does not recognize ``:class:`` option
* #9733: Fix for logging handler flushing warnings in the middle of the docs
build
* #9656: Fix warnings without subtype being incorrectly suppressed
@@ -574,7 +586,7 @@ Features added
* #9447: html theme: Expose the version of Sphinx in the form of tuple as a
template variable ``sphinx_version_tuple``
* #9594: manpage: Suppress the title of man page if description is empty
-* #9445: py domain: ``:py:property:`` directive supports ``:classmethod:``
+* #9445: py domain: :rst:dir:`py:property` directive supports ``:classmethod:``
option to describe the class property
* #9524: test: SphinxTestApp can take ``builddir`` as an argument
* #9535: C and C++, support more fundamental types, including GNU extensions.
@@ -6433,7 +6445,7 @@ Release 1.1.3 (Mar 10, 2012)
* #860: Do not crash when encountering invalid doctest examples, just
emit a warning.
-* #864: Fix crash with some settings of `modindex_common_prefix`.
+* #864: Fix crash with some settings of :confval:`modindex_common_prefix`.
* #862: Fix handling of ``-D`` and ``-A`` options on Python 3.
diff --git a/doc/_static/pocoo.png b/doc/_static/pocoo.png
deleted file mode 100644
index 1648bb8d7..000000000
--- a/doc/_static/pocoo.png
+++ /dev/null
Binary files differ
diff --git a/doc/_templates/contents.html b/doc/_templates/contents.html
new file mode 100644
index 000000000..003d8c3d7
--- /dev/null
+++ b/doc/_templates/contents.html
@@ -0,0 +1,6 @@
+{% extends "layout.html" %}
+{% set title = _('Sphinx documentation contents') %}
+{% block body %}
+<h1>{{ _('Sphinx documentation contents') }}</h1>
+{{ toctree(includehidden=True, collapse=False, maxdepth=3) }}
+{% endblock %}
diff --git a/doc/_templates/index.html b/doc/_templates/index.html
deleted file mode 100644
index 3cb884ab7..000000000
--- a/doc/_templates/index.html
+++ /dev/null
@@ -1,129 +0,0 @@
-{% extends "layout.html" %}
-{% set title = _('Overview') %}
-{% block body %}
- <h1>{{ _('Welcome') }}</h1>
-
- <div class="quotebar">
- <p><em>{%trans%}What users say:{%endtrans%}</em></p>
- <p>{%trans%}&#8220;Cheers for a great tool that actually makes programmers <b>want</b>
- to write documentation!&#8220;{%endtrans%}</p>
- </div>
-
- <p>{%trans%}
- Sphinx is a tool that makes it easy to create intelligent and beautiful
- documentation, written by Georg Brandl and licensed under the BSD license.{%endtrans%}</p>
- <p>{%trans%}It was originally created for <a href="https://docs.python.org/">the
- Python documentation</a>, and it has excellent facilities for the
- documentation of software projects in a range of languages. Of
- course, this site is also created from reStructuredText sources using
- Sphinx! The following features should be highlighted:{%endtrans%}
- </p>
- <ul>
- <li>{%trans%}<b>Output formats:</b> HTML (including Windows HTML Help), LaTeX (for
- printable PDF versions), ePub, Texinfo, manual pages, plain text{%endtrans%}</li>
- <li>{%trans%}<b>Extensive cross-references:</b> semantic markup and automatic links
- for functions, classes, citations, glossary terms and similar pieces of
- information{%endtrans%}</li>
- <li>{%trans%}<b>Hierarchical structure:</b> easy definition of a document tree, with
- automatic links to siblings, parents and children{%endtrans%}</li>
- <li>{%trans%}<b>Automatic indices:</b> general index as well as a language-specific
- module indices{%endtrans%}</li>
- <li>{%trans%}<b>Code handling:</b> automatic highlighting using the <a
- href="https://pygments.org">Pygments</a> highlighter{%endtrans%}</li>
- <li>{%trans path=pathto('ext/builtins')%}<b>Extensions:</b> automatic testing of code snippets, inclusion of
- docstrings from Python modules (API docs), and
- <a href="{{ path }}#builtin-sphinx-extensions">more</a>{%endtrans%}</li>
- <li>{%trans path=pathto("usage/extensions/index")%}<b>Contributed extensions:</b> dozens of
- extensions <a href="{{ path }}#third-party-extensions">contributed by users</a>;
- most of them installable from PyPI{%endtrans%}</li>
- </ul>
- <p>{%trans%}
- Sphinx uses <a href="https://docutils.sourceforge.io/rst.html">reStructuredText</a>
- as its markup language, and many of its strengths come from the power and
- straightforwardness of reStructuredText and its parsing and translating
- suite, the <a href="https://docutils.sourceforge.io/">Docutils</a>.{%endtrans%}
- </p>
-
- <h2 style="margin-bottom: 0">{%trans%}Documentation{%endtrans%}</h2>
-
- <table class="contentstable">
- <tr>
- <td>
- <p class="biglink"><a class="biglink" href="{{ pathto("usage/quickstart") }}">{%trans%}First steps with Sphinx{%endtrans%}</a><br/>
- <span class="linkdescr">{%trans%}overview of basic tasks{%endtrans%}</span></p>
- </td><td>
- <p class="biglink"><a class="biglink" href="{{ pathto("tutorial/index") }}">{%trans%}Tutorial{%endtrans%}</a><br/>
- <span class="linkdescr">{%trans%}beginners tutorial{%endtrans%}</span></p>
- </td>
- </tr><tr>
- <td>
- <p class="biglink"><a class="biglink" href="{{ pathto("contents") }}">{%trans%}Contents{%endtrans%}</a><br/>
- <span class="linkdescr">{%trans%}for a complete overview{%endtrans%}</span></p>
- </td><td>
- {%- if hasdoc('search') %}<p class="biglink"><a class="biglink" href="{{ pathto("search") }}">{%trans%}Search page{%endtrans%}</a><br/>
- <span class="linkdescr">{%trans%}search the documentation{%endtrans%}</span></p>{%- endif %}
- </td>
- </tr><tr>
- <td>
- <p class="biglink"><a class="biglink" href="{{ pathto("changes") }}">{%trans%}Changes{%endtrans%}</a><br/>
- <span class="linkdescr">{%trans%}release history{%endtrans%}</span></p>
- </td><td>
- {%- if hasdoc('genindex') %}<p class="biglink"><a class="biglink" href="{{ pathto("genindex") }}">{%trans%}General Index{%endtrans%}</a><br/>
- <span class="linkdescr">{%trans%}all functions, classes, terms{%endtrans%}</span></p>{%- endif %}
- </td><td>
- </tr>
- </table>
-
- <p>{%trans%}
- You can also download PDF/EPUB versions of the Sphinx documentation
- from pop up menu on lower right corner.{%endtrans%}
- </p>
-
- <h2>{%trans%}Examples{%endtrans%}</h2>
- <p>{%trans path=pathto("examples")%}Links to documentation generated with Sphinx can be found on the
- <a href="{{ path }}">Projects using Sphinx</a> page.{%endtrans%}
- </p>
- <p>{%trans%}
- For examples of how Sphinx source files look, use the &#8220;Show
- source&#8221; links on all pages of the documentation apart from this
- welcome page.{%endtrans%}
- </p>
-
- <p>{%trans%}You may also be interested in the very nice
- <a href="http://matplotlib.sourceforge.net/sampledoc/">tutorial</a> on how to
- create a customized documentation using Sphinx written by the matplotlib
- developers.{%endtrans%}</p>
-
- <p>{%trans%}There is a translation team in <a href="https://www.transifex.com/sphinx-doc/sphinx-doc/dashboard/">Transifex</a>
- of this documentation, thanks to the Sphinx document translators.{%endtrans%}</p>
- <p>{%trans%}A Japanese book about Sphinx has been published by O'Reilly:
- <a href="https://www.oreilly.co.jp/books/9784873116488/">Sphinxをはじめよう /
- Learning Sphinx</a>.{%endtrans%}</p>
- <p>{%trans%}In 2019 the second edition of a German book about Sphinx was published:
- <a href="https://literatur.hasecke.com/post/software-dokumentation-mit-sphinx/">Software-Dokumentation mit Sphinx</a>.{%endtrans%}</p>
- <!-- <p><img src="{{ pathto("_static/bookcover.png", 1) }}"/></p> -->
-
-
- <h2>{%trans%}Hosting{%endtrans%}</h2>
-
- <p>{%trans%}Need a place to host your Sphinx docs?
- <a href="https://readthedocs.org/">readthedocs.org</a> hosts a lot of Sphinx docs
- already, and integrates well with projects' source control. It also features a
- powerful built-in search that exceeds the possibilities of Sphinx' JavaScript-based
- offline search.{%endtrans%}</p>
-
- <h2>{%trans%}Contributor Guide{%endtrans%}</h2>
-
- <p>{%trans%}If you want to contribute to the project,
- this part of the documentation is for you.{%endtrans%}</p>
-
- <ul>
- <li>{%trans path=pathto("internals/contributing")%}<a href="{{ path }}">Sphinx Contributors’ Guide</a></li>{%endtrans%}
- <li>{%trans path=pathto("internals/authors")%}<a href="{{ path }}">Sphinx Authors</a></li>{%endtrans%}
- </ul>
-
- <h2>{%trans%}Code of Conduct{%endtrans%}</h2>
-
- <p>{%trans path=pathto("internals/code-of-conduct")%}Please adhere to our <a href="{{ path }}">Code of Conduct</a>.{%endtrans%}</p>
-
-{% endblock %}
diff --git a/doc/_templates/indexsidebar.html b/doc/_templates/indexsidebar.html
deleted file mode 100644
index e765648b2..000000000
--- a/doc/_templates/indexsidebar.html
+++ /dev/null
@@ -1,23 +0,0 @@
-<p class="logo">A <a href="https://www.pocoo.org/">
- <img src="{{ pathto("_static/pocoo.png", 1) }}" alt="Pocoo" /></a>
- {%trans%}project{%endtrans%}</p>
-
-<h3>Download</h3>
-<p class="download">{%trans%}Current version: <a href="https://pypi.org/project/Sphinx/" alt="PyPI"><img src="https://img.shields.io/pypi/v/sphinx.svg"></a>{%endtrans%}</p>
-<p>{%trans%}Install Sphinx with:{%endtrans%}</p>
-<pre>pip install -U Sphinx</pre>
-
-<h3>{%trans%}Questions? Suggestions?{%endtrans%}</h3>
-
-<p>{%trans%}Join the <a href="https://groups.google.com/group/sphinx-users">sphinx-users</a> mailing list on Google Groups:{%endtrans%}</p>
-<div class="subscribeformwrapper">
-<form action="https://groups.google.com/group/sphinx-users/boxsubscribe"
- class="subscribeform">
- <input type="text" name="email" value="your@email"
- onfocus="this.value = ''" />
- <input type="submit" name="sub" value="Subscribe" />
-</form>
-</div>
-<p>{%trans%}or come to the <tt>#sphinx-doc</tt> channel on <a href="https://web.libera.chat/?channel=#sphinx-doc">libera.chat</a>.{%endtrans%}</p>
-<p>{%trans%}You can also open an issue at the
- <a href="https://github.com/sphinx-doc/sphinx/issues">tracker</a>.{%endtrans%}</p>
diff --git a/doc/_themes/sphinx13/layout.html b/doc/_themes/sphinx13/layout.html
index 7fe550ebd..f6f858a57 100644
--- a/doc/_themes/sphinx13/layout.html
+++ b/doc/_themes/sphinx13/layout.html
@@ -1,75 +1,60 @@
-{#
- sphinxdoc/layout.html
- ~~~~~~~~~~~~~~~~~~~~~
-
- Sphinx layout template for the sphinxdoc theme.
-
- :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
- :license: BSD, see LICENSE for details.
-#}
+{# Sphinx layout template for the sphinxdoc theme. #}
{%- extends "basic/layout.html" %}
-{# put the sidebar before the body #}
-{% block sidebar1 %}{{ sidebar() }}{% endblock %}
-{% block sidebar2 %}{% endblock %}
-
{% block extrahead %}
- <link href='https://fonts.googleapis.com/css?family=Open+Sans:300,400,700'
- rel='stylesheet' type='text/css' />
{{ super() }}
-{%- if not embedded %}
- <style type="text/css">
- table.right { float: right; margin-left: 20px; }
- table.right td { border: 1px solid #ccc; }
- {% if pagename == 'index' %}
- .related { display: none; }
- {% endif %}
- </style>
- <script>
- // intelligent scrolling of the sidebar content
- window.onscroll = () => {
- const sb = document.getElementsByClassName('sphinxsidebarwrapper')[0]
- const sbh = sb.offsetHeight
- const offset = document.getElementsByClassName('sphinxsidebar')[0].offsetTop;
- const wintop = window.scrollTop;
- const winbot = wintop + window.offsetHeight
- const curtop = sb.offsetTop;
- const curbot = curtop + sbh;
- // does sidebar fit in window?
- if (sbh < window.offsetHeight) {
- // yes: easy case -- always keep at the top
- sb.style.top = Math.min(Math.max(0, wintop - offset - 10), window.innerHeight - sbh - 200)
- } else {
- // no: only scroll if top/bottom edge of sidebar is at
- // top/bottom edge of window
- if (curtop > wintop && curbot > winbot) {
- sb.style.top = Math.max(wintop - offset - 10, 0)
- } else if (curtop < wintop && curbot < winbot) {
- sb.style.top = Math.min(winbot - sbh - offset - 20, window.innerHeight - sbh - 200)
- }
- }
- }
- </script>
+{%- if not embedded and pagename == 'index' %}
+<style>.related { display: none; }</style>
{%- endif %}
{% endblock %}
-{% block rootrellink %}
- <li><a href="{{ pathto('index') }}">Sphinx home</a>&#160;|</li>
- <li><a href="{{ pathto('contents') }}">Documentation</a> &#187;</li>
-{% endblock %}
-
{% block header %}
<div class="pageheader">
+<a href="{{ pathto('index') }}">
+ <img src="{{ pathto('_static/sphinxheader.png', 1) }}" alt="SPHINX" />
+</a>
+</div>
+{% endblock %}
+
+{%- block relbar1 %}
+<div class="related" role="navigation" aria-label="related navigation">
+ <h3>{{ _('Navigation') }}</h3>
<ul>
- <li><a href="{{ pathto('index') }}">Home</a></li>
- <li><a href="{{ pathto('usage/installation') }}">Get it</a></li>
- <li><a href="{{ pathto('contents') }}">Docs</a></li>
- <li><a href="{{ pathto('development/index') }}">Extend</a></li>
+ <li><a href="{{ pathto('index') }}">Documentation</a> &raquo;</li>
+ {%- for parent in parents %}
+ <li class="nav-item nav-item-{{ loop.index }}"><a href="{{ parent.link|e }}" {% if loop.last %}{{ accesskey("U") }}{% endif %}>{{ parent.title }}</a>{{ reldelim1 }}</li>
+ {%- endfor %}
+ <li class="nav-item nav-item-this"><a href="{{ link|e }}">{{ title }}</a></li>
</ul>
+</div>
+{% endblock %}
+
+{%- block content %}
+<div class="document">
+ <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
+ {%- include "searchbox.html" %}
<div>
- <a href="{{ pathto('index') }}">
- <img src="{{ pathto('_static/sphinxheader.png', 1) }}" alt="SPHINX" />
- </a>
+ <h3>{{ _('Contents') }}</h3>
+ {%- if pagename != "index" %}
+ {{ toc }}
+ {%- else %}
+ {{ toctree(includehidden=True, maxdepth=3) }}
+ {%- endif %}
+ </div>
+ </div>
+ {%- block document %}
+ <div class="body" role="main">
+ {% block body %}{% endblock %}
</div>
+ {%- endblock %}
</div>
-{% endblock %}
+{%- endblock %}
+
+{%- block relbar2 %}{% endblock %}
+
+{%- block footer %}
+<div class="footer" role="contentinfo">
+ {% trans path=pathto('copyright'), copyright=copyright|e %}&#169; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
+ {% trans sphinx_version=sphinx_version|e %}Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> {{ sphinx_version }}.{% endtrans %}
+</div>
+{%- endblock %}
diff --git a/doc/_themes/sphinx13/static/bodybg.png b/doc/_themes/sphinx13/static/bodybg.png
deleted file mode 100644
index 6f667b99e..000000000
--- a/doc/_themes/sphinx13/static/bodybg.png
+++ /dev/null
Binary files differ
diff --git a/doc/_themes/sphinx13/static/footerbg.png b/doc/_themes/sphinx13/static/footerbg.png
deleted file mode 100644
index d1bcb009b..000000000
--- a/doc/_themes/sphinx13/static/footerbg.png
+++ /dev/null
Binary files differ
diff --git a/doc/_themes/sphinx13/static/headerbg.png b/doc/_themes/sphinx13/static/headerbg.png
deleted file mode 100644
index 522504964..000000000
--- a/doc/_themes/sphinx13/static/headerbg.png
+++ /dev/null
Binary files differ
diff --git a/doc/_themes/sphinx13/static/listitem.png b/doc/_themes/sphinx13/static/listitem.png
deleted file mode 100644
index f7f814d00..000000000
--- a/doc/_themes/sphinx13/static/listitem.png
+++ /dev/null
Binary files differ
diff --git a/doc/_themes/sphinx13/static/relbg.png b/doc/_themes/sphinx13/static/relbg.png
deleted file mode 100644
index 68a9b77eb..000000000
--- a/doc/_themes/sphinx13/static/relbg.png
+++ /dev/null
Binary files differ
diff --git a/doc/_themes/sphinx13/static/sphinx13.css b/doc/_themes/sphinx13/static/sphinx13.css
index 5d64eda51..562b1757b 100644
--- a/doc/_themes/sphinx13/static/sphinx13.css
+++ b/doc/_themes/sphinx13/static/sphinx13.css
@@ -1,187 +1,74 @@
-/*
- * sphinx13.css
- * ~~~~~~~~~~~~
- *
- * Sphinx stylesheet -- sphinx13 theme.
- *
- * :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
+/* Stylesheet for Sphinx's documentation */
-@import url("basic.css");
-
-/* -- page layout ----------------------------------------------------------- */
+/* Set master colours */
+:root {
+ --fonts-sans-serif: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+ --colour-sphinx-blue: #0A507A;
+ --colour-text: #333;
+ --colour-links-light: #057;
+}
body {
- font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
- 'Verdana', sans-serif;
- font-size: 14px;
- text-align: center;
- background-image: url(bodybg.png);
- color: black;
- padding: 0;
- border-right: 1px solid #0a507a;
- border-left: 1px solid #0a507a;
-
+ font-family: var(--fonts-sans-serif);
margin: 0 auto;
- min-width: 780px;
- max-width: 1080px;
+ color: var(--colour-text);
}
.pageheader {
- background-image: url(headerbg.png);
- text-align: left;
+ background-color: var(--colour-sphinx-blue);
padding: 10px 15px;
}
-.pageheader ul {
- float: right;
- color: white;
- list-style-type: none;
- padding-left: 0;
- margin-top: 30px;
- margin-right: 10px;
-}
-
-.pageheader li {
- float: left;
- margin: 0 0 0 10px;
-}
-
-.pageheader li a {
- border-radius: 1px;
- padding: 8px 12px;
- color: #f9f9f0;
- text-shadow: 0 0 5px rgba(0, 0, 0, 0.5);
-}
-
-.pageheader li a:hover {
- background-color: #f9f9f0;
- color: #0a507a;
- text-shadow: none;
-}
-
div.document {
- background-color: white;
- text-align: left;
-}
-
-div.bodywrapper {
- margin: 0 240px 0 0;
- border-right: 1px solid #0a507a;
+ display: flex;
+ margin: 0 0.5em;
}
div.body {
+ border-left: 1px solid var(--colour-sphinx-blue);
margin: 0;
- padding: 0.5em 20px 20px 20px;
+ padding: 0.5em 1.25em;
+ min-width: 0;
+ max-width: 800px;
}
div.related {
- font-size: 1em;
+ display: flex;
color: white;
-}
-
-div.related ul {
- background-image: url(relbg.png);
- height: 1.9em;
+ background-color: var(--colour-sphinx-blue);
border-top: 1px solid #002e50;
- border-bottom: 1px solid #002e50;
}
div.related ul li {
margin: 0 5px 0 0;
- padding: 0;
float: left;
}
-div.related ul li.right {
- float: right;
- margin-right: 5px;
-}
-
div.related ul li a {
- margin: 0;
padding: 0 5px 0 5px;
line-height: 1.75em;
- color: #f9f9f0;
- text-shadow: 0px 0px 1px rgba(0, 0, 0, 0.5);
+ color: white;
}
div.related ul li a:hover {
- color: white;
- /*text-decoration: underline;*/
- text-shadow: 0px 0px 1px rgba(255, 255, 255, 0.5);
+ text-shadow: 0 0 1px rgba(255, 255, 255, 0.5);
}
div.sphinxsidebarwrapper {
- position: relative;
- top: 0px;
padding: 0;
}
div.sphinxsidebar {
+ overflow-wrap: break-word;
margin: 0;
- padding: 0 15px 15px 0;
+ padding-right: 15px;
width: 210px;
- float: right;
font-size: 1em;
- text-align: left;
- max-height: 0px;
-}
-
-div.sphinxsidebar .logo {
- font-size: 1.8em;
- color: #0A507A;
- font-weight: 300;
- text-align: center;
-}
-
-div.sphinxsidebar .logo img {
- vertical-align: middle;
-}
-
-div.sphinxsidebar .download a img {
- vertical-align: middle;
-}
-
-div.subscribeformwrapper {
- display: block;
- overflow: auto;
- margin-bottom: 1.2em;
-}
-
-div.sphinxsidebar input {
- border: 1px solid #aaa;
- font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
- 'Verdana', sans-serif;
-}
-
-div.sphinxsidebar .subscribeform {
- margin-top: 0;
-}
-
-div.sphinxsidebar .subscribeform input {
- border: 1px solid #aaa;
- font-size: 0.9em;
- float: left;
- padding: 0.25em 0.5em;
- box-sizing: border-box;
-}
-
-div.sphinxsidebar .subscribeform input[type="text"] {
- width: 60%;
-}
-
-div.sphinxsidebar .subscribeform input[type="submit"] {
- width: 40%;
- border-left: none;
}
div.sphinxsidebar h3 {
font-size: 1.5em;
- border-top: 1px solid #0a507a;
- margin-top: 1em;
+ margin-top: 0;
margin-bottom: 0.5em;
padding-top: 0.5em;
}
@@ -198,12 +85,6 @@ div.sphinxsidebar h3, div.sphinxsidebar h4 {
padding-left: 14px;
color: #333;
font-weight: 300;
- /*text-shadow: 0px 0px 0.5px rgba(0, 0, 0, 0.4);*/
-}
-
-div.sphinxsidebarwrapper > h3:first-child {
- margin-top: 0.5em;
- border: none;
}
div.sphinxsidebar h3 a {
@@ -219,17 +100,16 @@ div.sphinxsidebar ul {
div.sphinxsidebar ul ul {
margin-left: 20px;
- list-style-image: url(listitem.png);
+ list-style-type: none;
}
div.footer {
- background-image: url(footerbg.png);
+ background-color: var(--colour-sphinx-blue);
color: #ccc;
text-shadow: 0 0 .2px rgba(255, 255, 255, 0.8);
padding: 3px 8px 3px 0;
clear: both;
font-size: 0.8em;
- text-align: right;
}
/* no need to make a visible link to Sphinx on the Sphinx page */
@@ -244,14 +124,10 @@ p {
}
a {
- color: #A2881D;
+ color: var(--colour-links-light);
text-decoration: none;
}
-a:hover {
- color: #E1C13F;
-}
-
div.body a {
text-decoration: underline;
}
@@ -259,12 +135,18 @@ div.body a {
h1 {
margin: 10px 0 0 0;
font-size: 2.4em;
- color: #0A507A;
+ color: var(--colour-sphinx-blue);
font-weight: 300;
}
+h1 span.pre {
+ /* for code in titles */
+ word-break: break-all;
+ white-space: normal;
+}
+
h2 {
- margin: 1.em 0 0.2em 0;
+ margin: 1em 0 0.2em 0;
font-size: 1.5em;
font-weight: 300;
padding: 0;
@@ -282,12 +164,12 @@ div.body h1 a, div.body h2 a, div.body h3 a, div.body h4 a, div.body h5 a, div.b
}
div.body h1 a tt, div.body h2 a tt, div.body h3 a tt, div.body h4 a tt, div.body h5 a tt, div.body h6 a tt {
- color: #0A507A !important;
+ color: var(--colour-sphinx-blue) !important;
font-size: inherit !important;
}
a.headerlink {
- color: #0A507A !important;
+ color: var(--colour-sphinx-blue) !important;
font-size: 12px;
margin-left: 6px;
padding: 0 4px 0 4px;
@@ -308,7 +190,7 @@ h1 code, h2 code, h3 code, h4 code {
cite, code, tt {
font-family: 'Consolas', 'DejaVu Sans Mono',
'Bitstream Vera Sans Mono', monospace;
- font-size: 14px;
+ font-size: 1em;
letter-spacing: -0.02em;
}
@@ -335,17 +217,13 @@ hr {
a tt {
border: 0;
- color: #a2881d;
-}
-
-a tt:hover {
- color: #e1c13f;
+ color: var(--colour-links-light);
}
pre {
font-family: 'Consolas', 'Courier New', 'DejaVu Sans Mono',
'Bitstream Vera Sans Mono', monospace;
- font-size: 13px;
+ font-size: 1em;
letter-spacing: 0.015em;
line-height: 120%;
padding: 0.5em;
@@ -428,8 +306,7 @@ div.admonition div.highlight {
}
.viewcode-back {
- font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
- 'Verdana', sans-serif;
+ font-family: var(--fonts-sans-serif);
}
div.viewcode-block:target {
@@ -438,8 +315,15 @@ div.viewcode-block:target {
border-bottom: 1px solid #ac9;
}
-.contentstable {
- margin-left: 30px;
- margin: 0 auto;
- table-layout: fixed;
+
+/* media queries */
+
+/* Reduce padding & margins for smaller screens */
+@media (max-width: 750px) {
+ .sphinxsidebar {
+ display: none;
+ }
+ div.body {
+ border-left: none;
+ }
}
diff --git a/doc/_themes/sphinx13/theme.conf b/doc/_themes/sphinx13/theme.conf
index 19a480a6b..78bb78f10 100644
--- a/doc/_themes/sphinx13/theme.conf
+++ b/doc/_themes/sphinx13/theme.conf
@@ -1,4 +1,4 @@
[theme]
inherit = basic
-stylesheet = sphinx13.css
pygments_style = default
+sidebars =
diff --git a/doc/conf.py b/doc/conf.py
index 4afd5e63c..e305f604c 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -2,6 +2,7 @@
import os
import re
+import time
import sphinx
@@ -10,23 +11,25 @@ extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo',
'sphinx.ext.intersphinx',
'sphinx.ext.viewcode', 'sphinx.ext.inheritance_diagram']
-root_doc = 'contents'
templates_path = ['_templates']
exclude_patterns = ['_build']
project = 'Sphinx'
-copyright = '2007-2022, Georg Brandl and the Sphinx team'
+copyright = f'2007-{time.strftime("%Y")}, the Sphinx developers'
version = sphinx.__display_version__
release = version
show_authors = True
html_theme = 'sphinx13'
html_theme_path = ['_themes']
+html_css_files = [
+ # 'basic.css', # included through inheritance from the basic theme
+ 'sphinx13.css',
+]
modindex_common_prefix = ['sphinx.']
html_static_path = ['_static']
-html_sidebars = {'index': ['indexsidebar.html', 'searchbox.html']}
html_title = 'Sphinx documentation'
-html_additional_pages = {'index': 'index.html'}
+html_additional_pages = {'contents': 'contents.html'}
html_use_opensearch = 'https://www.sphinx-doc.org/en/master'
html_baseurl = 'https://www.sphinx-doc.org/en/master/'
html_favicon = '_static/favicon.svg'
@@ -35,7 +38,7 @@ htmlhelp_basename = 'Sphinxdoc'
epub_theme = 'epub'
epub_basename = 'sphinx'
-epub_author = 'Georg Brandl'
+epub_author = 'the Sphinx developers'
epub_publisher = 'https://www.sphinx-doc.org/'
epub_uid = 'web-site'
epub_scheme = 'url'
@@ -52,11 +55,10 @@ epub_fix_images = False
epub_max_image_width = 0
epub_show_urls = 'inline'
epub_use_index = False
-epub_guide = (('toc', 'contents.xhtml', 'Table of Contents'),)
epub_description = 'Sphinx documentation generator system manual'
-latex_documents = [('contents', 'sphinx.tex', 'Sphinx Documentation',
- 'Georg Brandl', 'manual', 1)]
+latex_documents = [('index', 'sphinx.tex', 'Sphinx Documentation',
+ 'the Sphinx developers', 'manual', 1)]
latex_logo = '_static/sphinx.png'
latex_elements = {
'fontenc': r'\usepackage[LGR,X2,T1]{fontenc}',
@@ -74,6 +76,11 @@ latex_elements = {
{\footnotesize\raggedright\printindex}
{\begin{sphinxtheindex}\end{sphinxtheindex}}
''',
+ 'sphinxsetup': """%
+VerbatimColor={RGB}{242,242,242},%
+VerbatimBorderColor={RGB}{32,32,32},%
+verbatimradius=3pt%
+""",
}
latex_show_urls = 'footnote'
latex_use_xindy = True
@@ -89,8 +96,8 @@ extlinks = {'duref': ('https://docutils.sourceforge.io/docs/ref/rst/'
'directives.html#%s', '%s')}
man_pages = [
- ('contents', 'sphinx-all', 'Sphinx documentation generator system manual',
- 'Georg Brandl', 1),
+ ('index', 'sphinx-all', 'Sphinx documentation generator system manual',
+ 'the Sphinx developers', 1),
('man/sphinx-build', 'sphinx-build', 'Sphinx documentation generator tool',
'', 1),
('man/sphinx-quickstart', 'sphinx-quickstart', 'Sphinx documentation '
@@ -102,7 +109,7 @@ man_pages = [
]
texinfo_documents = [
- ('contents', 'sphinx', 'Sphinx Documentation', 'Georg Brandl',
+ ('index', 'sphinx', 'Sphinx Documentation', 'the Sphinx developers',
'Sphinx', 'The Sphinx documentation builder.', 'Documentation tools',
1),
]
diff --git a/doc/contents.rst b/doc/contents.rst
deleted file mode 100644
index 21a27e233..000000000
--- a/doc/contents.rst
+++ /dev/null
@@ -1,39 +0,0 @@
-.. _contents:
-
-Sphinx documentation contents
-=============================
-
-.. toctree::
- :maxdepth: 2
-
- usage/index
- tutorial/index
- development/index
- man/index
-
- templating
- latex
- extdev/index
-
- internals/index
-
- faq
- glossary
- changes
- examples
-
-
-Indices and tables
-==================
-
-.. only:: builder_html
-
- * :ref:`genindex`
- * :ref:`modindex`
- * :ref:`search`
- * :ref:`glossary`
-
-.. only:: not builder_html
-
- * :ref:`modindex`
- * :ref:`glossary`
diff --git a/doc/index.rst b/doc/index.rst
new file mode 100644
index 000000000..50571cdb7
--- /dev/null
+++ b/doc/index.rst
@@ -0,0 +1,101 @@
+=======
+Welcome
+=======
+
+**Sphinx makes it easy to create intelligent and beautiful documentation.**
+
+Install
+=======
+
+Install Sphinx with ``pip install -U Sphinx``. See :doc:`usage/installation` for
+further details.
+
+Features
+========
+
+* **Output formats:** HTML (including Windows HTML Help), LaTeX (for printable
+ PDF versions), ePub, Texinfo, manual pages, plain text
+* **Extensive cross-references:** semantic markup and automatic links for
+ functions, classes, citations, glossary terms and similar pieces of
+ information
+* **Hierarchical structure:** easy definition of a document tree, with automatic
+ links to siblings, parents and children
+* **Automatic indices:** general index as well as a language-specific module
+ indices
+* **Code handling:** automatic highlighting using the Pygments_ highlighter
+* **Extensions:** automatic testing of code snippets, inclusion of docstrings
+ from Python modules (API docs), and :ref:`more <builtin-extensions>`
+* **Contributed extensions:** dozens of extensions
+ :ref:`contributed by users <third-party-extensions>`; most of them installable
+ from PyPI
+
+.. _Pygments: https://pygments.org/
+
+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_.
+
+.. _reStructuredText: https://docutils.sourceforge.io/rst.html
+.. _Docutils: https://docutils.sourceforge.io/
+
+Documentation
+=============
+
+* :doc:`First steps with Sphinx <usage/quickstart>`: overview of basic tasks
+* :doc:`Tutorial <tutorial/index>`: beginners tutorial
+* :ref:`Search page <search>`: search the documentation
+* :doc:`Changes <changes>`: release history
+* :ref:`General Index <genindex>`: all functions, classes, terms
+* :ref:`Python Module Index <modindex>`: the index of Python modules
+* :doc:`Glossary <glossary>`: definitions of various terms
+* :doc:`Sphinx's Authors <internals/authors>`: the Sphinx developers
+* `Contents <contents.html>`__: full table of contents
+
+Support
+=======
+
+For questions or to report problems with Sphinx, join the `sphinx-users`_
+mailing list on Google Groups, come to the ``#sphinx-doc`` channel on
+`libera.chat`_, or open an issue at the tracker_.
+
+.. _sphinx-users: https://groups.google.com/group/sphinx-users
+.. _libera.chat: https://web.libera.chat/?channel=#sphinx-doc
+.. _tracker: https://github.com/sphinx-doc/sphinx/issues
+
+Examples of other projects using Sphinx can be found in the :doc:`examples page
+<examples>`. A useful tutorial_ has been written by the matplotlib developers.
+
+.. _tutorial: http://matplotlib.sourceforge.net/sampledoc/
+
+There is a translation team in Transifex_ of this documentation, thanks to the
+Sphinx document translators.
+
+.. _Transifex: https://www.transifex.com/sphinx-doc/sphinx-doc/dashboard/
+
+Contributor guide
+=================
+
+See the :doc:`Sphinx contributors' guide <internals/contributing>` if you would
+like to contribute to the project.
+
+.. master toctree:
+
+.. toctree::
+ :maxdepth: 5
+ :hidden:
+
+ usage/index
+ tutorial/index
+ development/index
+ man/index
+
+ templating
+ latex
+ extdev/index
+
+ internals/index
+
+ faq
+ glossary
+ changes
+ examples
diff --git a/doc/latex.rst b/doc/latex.rst
index 0140d0b2c..4d1644504 100644
--- a/doc/latex.rst
+++ b/doc/latex.rst
@@ -8,8 +8,11 @@ LaTeX customization
\begingroup
\sphinxsetup{%
- verbatimwithframe=false,
+ verbatimborder=2pt,
+ verbatimsep=5pt,
+ verbatimradius=5pt,
VerbatimColor={named}{OldLace},
+ VerbatimBorderColor={named}{Gold},
TitleColor={named}{DarkGoldenrod},
hintBorderColor={named}{LightCoral},
attentionborder=3pt,
@@ -580,8 +583,17 @@ start of the chapter::
\begingroup
\sphinxsetup{%
- verbatimwithframe=false,
+ % These were used as defaults for the whole sphinx.pdf
+ % VerbatimColor={RGB}{242,242,242},%
+ % VerbatimBorderColor={RGB}{32,32,32},%
+ % verbatimradius=3pt,%
+ % New definitions for this chapter code-blocks only:
VerbatimColor={named}{OldLace},
+ VerbatimBorderColor={named}{Gold},
+ verbatimradius=5pt,
+ verbatimsep=5pt,
+ verbatimborder=2pt,
+ % Other configuration for this chapter only:
TitleColor={named}{DarkGoldenrod},
hintBorderColor={named}{LightCoral},
attentionborder=3pt,
@@ -593,7 +605,8 @@ start of the chapter::
cautionBorderColor={named}{Cyan},
cautionBgColor={named}{LightCyan}}
-The below is included at the end of the chapter::
+And this is placed at the end of the chapter source to end the scope of
+the configuration::
.. raw:: latex
@@ -839,6 +852,32 @@ Do not use quotes to enclose values, whether numerical or strings.
Default: ``\fboxrule``
+``verbatimradius``
+ The radius of the rounded corners of the frame around :rst:dir:`code-block`\ s.
+
+ Default: ``0pt``
+
+ .. versionadded:: 5.1.0
+
+ If non-zero, it will trigger the loading of LaTeX package pict2e_.
+
+ .. caution::
+
+ The interface will remain experimental during the 5.x cycle: the
+ feature itself will remain, but the interface may evolve to include
+ other display elements such as admonitions. For the latter it is
+ actually already possible for LaTeX-expert Sphinx users to use
+ functionalities of LaTeX packages such as tcolorbox_, via
+ redefinitions of the ``sphinxheavybox`` and ``sphinxlightbox``
+ `Environments`_. This would be more difficult for code-blocks, and
+ this key achieves it. The pict2e_ interface to some basic PDF
+ graphics operations is much more light-weight than the pgf_
+ framework used by tcolorbox_.
+
+ .. _pict2e: https://ctan.org/pkg/pict2e
+ .. _tcolorbox: https://ctan.org/pkg/tcolorbox
+ .. _pgf: https://ctan.org/pkg/pgf
+
``shadowsep``
The separation between contents and frame for :dudir:`contents` and
:dudir:`topic` boxes.
diff --git a/doc/tutorial/end.rst b/doc/tutorial/end.rst
index ba96abca0..9f35b0752 100644
--- a/doc/tutorial/end.rst
+++ b/doc/tutorial/end.rst
@@ -2,5 +2,5 @@ Where to go from here
=====================
This tutorial covered the very first steps to create a documentation project
-with Sphinx. To continue learning more about Sphinx, check out the :ref:`rest
-of the documentation <contents>`.
+with Sphinx. To continue learning more about Sphinx, check out the `rest of the
+documentation <../contents.html>`__.
diff --git a/sphinx/application.py b/sphinx/application.py
index caf6ce4db..fe7839529 100644
--- a/sphinx/application.py
+++ b/sphinx/application.py
@@ -128,7 +128,8 @@ class Sphinx:
buildername: str, confoverrides: Dict = None,
status: Optional[IO] = sys.stdout, warning: Optional[IO] = sys.stderr,
freshenv: bool = False, warningiserror: bool = False, tags: List[str] = None,
- verbosity: int = 0, parallel: int = 0, keep_going: bool = False) -> None:
+ verbosity: int = 0, parallel: int = 0, keep_going: bool = False,
+ pdb: bool = False) -> None:
self.phase = BuildPhase.INITIALIZATION
self.verbosity = verbosity
self.extensions: Dict[str, Extension] = {}
@@ -170,6 +171,7 @@ class Sphinx:
self.warningiserror = False
else:
self.warningiserror = warningiserror
+ self.pdb = pdb
logging.setup(self, self._status, self._warning)
self.events = EventManager(self)
diff --git a/sphinx/cmd/build.py b/sphinx/cmd/build.py
index ce0b14c75..259af2eb2 100644
--- a/sphinx/cmd/build.py
+++ b/sphinx/cmd/build.py
@@ -272,7 +272,8 @@ def build_main(argv: List[str] = sys.argv[1:]) -> int:
app = Sphinx(args.sourcedir, args.confdir, args.outputdir,
args.doctreedir, args.builder, confoverrides, status,
warning, args.freshenv, args.warningiserror,
- args.tags, args.verbosity, args.jobs, args.keep_going)
+ args.tags, args.verbosity, args.jobs, args.keep_going,
+ args.pdb)
app.build(args.force_all, filenames)
return app.statuscode
except (Exception, KeyboardInterrupt) as exc:
diff --git a/sphinx/events.py b/sphinx/events.py
index 5302cd005..448af0695 100644
--- a/sphinx/events.py
+++ b/sphinx/events.py
@@ -98,6 +98,9 @@ class EventManager:
except SphinxError:
raise
except Exception as exc:
+ if self.app.pdb:
+ # Just pass through the error, so that it can be debugged.
+ raise
modname = safe_getattr(listener.handler, '__module__', None)
raise ExtensionError(__("Handler %r for event %r threw an exception") %
(listener.handler, name), exc, modname=modname) from exc
diff --git a/sphinx/locale/ar/LC_MESSAGES/sphinx.mo b/sphinx/locale/ar/LC_MESSAGES/sphinx.mo
index 167e452f7..345f78250 100644
--- a/sphinx/locale/ar/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ar/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ar/LC_MESSAGES/sphinx.po b/sphinx/locale/ar/LC_MESSAGES/sphinx.po
index e743b5990..db2c8fb57 100644
--- a/sphinx/locale/ar/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ar/LC_MESSAGES/sphinx.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Abdullah ahmed <Alhadab@hotmail.co.uk>, 2020\n"
"Language-Team: Arabic (http://www.transifex.com/sphinx-doc/sphinx-1/language/ar/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/bg/LC_MESSAGES/sphinx.mo b/sphinx/locale/bg/LC_MESSAGES/sphinx.mo
index b65289182..685d9fc04 100644
--- a/sphinx/locale/bg/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/bg/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/bg/LC_MESSAGES/sphinx.po b/sphinx/locale/bg/LC_MESSAGES/sphinx.po
index f5544df91..4e297595e 100644
--- a/sphinx/locale/bg/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/bg/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Bulgarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/bg/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/bn/LC_MESSAGES/sphinx.mo b/sphinx/locale/bn/LC_MESSAGES/sphinx.mo
index 1132d485c..2bcd969bc 100644
--- a/sphinx/locale/bn/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/bn/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/bn/LC_MESSAGES/sphinx.po b/sphinx/locale/bn/LC_MESSAGES/sphinx.po
index ab58ae15b..8e81414e7 100644
--- a/sphinx/locale/bn/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/bn/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2009\n"
"Language-Team: Bengali (http://www.transifex.com/sphinx-doc/sphinx-1/language/bn/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/ca/LC_MESSAGES/sphinx.mo b/sphinx/locale/ca/LC_MESSAGES/sphinx.mo
index a2bca6eb0..daf0f896c 100644
--- a/sphinx/locale/ca/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ca/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ca/LC_MESSAGES/sphinx.po b/sphinx/locale/ca/LC_MESSAGES/sphinx.po
index bf05b56db..beb620ac1 100644
--- a/sphinx/locale/ca/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ca/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2009\n"
"Language-Team: Catalan (http://www.transifex.com/sphinx-doc/sphinx-1/language/ca/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/cak/LC_MESSAGES/sphinx.mo b/sphinx/locale/cak/LC_MESSAGES/sphinx.mo
index 11a101ebf..e38ab326a 100644
--- a/sphinx/locale/cak/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/cak/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/cak/LC_MESSAGES/sphinx.po b/sphinx/locale/cak/LC_MESSAGES/sphinx.po
index b69e017fe..a0e09e21c 100644
--- a/sphinx/locale/cak/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/cak/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Julien Malard <julien.malard@mail.mcgill.ca>, 2019\n"
"Language-Team: Kaqchikel (http://www.transifex.com/sphinx-doc/sphinx-1/language/cak/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/cs/LC_MESSAGES/sphinx.mo b/sphinx/locale/cs/LC_MESSAGES/sphinx.mo
index 022f74f3f..7cb370ccf 100644
--- a/sphinx/locale/cs/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/cs/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/cs/LC_MESSAGES/sphinx.po b/sphinx/locale/cs/LC_MESSAGES/sphinx.po
index e39ce2ef0..c327b0aa8 100644
--- a/sphinx/locale/cs/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/cs/LC_MESSAGES/sphinx.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Vilibald W. <vilibald.wanca@gmail.com>, 2014-2015\n"
"Language-Team: Czech (http://www.transifex.com/sphinx-doc/sphinx-1/language/cs/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/cy/LC_MESSAGES/sphinx.mo b/sphinx/locale/cy/LC_MESSAGES/sphinx.mo
index 7de3f5f1a..45586313b 100644
--- a/sphinx/locale/cy/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/cy/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/cy/LC_MESSAGES/sphinx.po b/sphinx/locale/cy/LC_MESSAGES/sphinx.po
index 4eb5413d7..4c009726e 100644
--- a/sphinx/locale/cy/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/cy/LC_MESSAGES/sphinx.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Geraint Palmer <palmer.geraint@googlemail.com>, 2016\n"
"Language-Team: Welsh (http://www.transifex.com/sphinx-doc/sphinx-1/language/cy/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/da/LC_MESSAGES/sphinx.mo b/sphinx/locale/da/LC_MESSAGES/sphinx.mo
index d32eb8759..f7997ea77 100644
--- a/sphinx/locale/da/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/da/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/da/LC_MESSAGES/sphinx.po b/sphinx/locale/da/LC_MESSAGES/sphinx.po
index 272405acd..caf65563a 100644
--- a/sphinx/locale/da/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/da/LC_MESSAGES/sphinx.po
@@ -6,14 +6,14 @@
# askhl <asklarsen@gmail.com>, 2010-2011
# Jakob Lykke Andersen <jakob@caput.dk>, 2014,2016
# Joe Hansen <joedalton2@yahoo.dk>, 2016,2019
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2021
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>, 2021\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2021\n"
"Language-Team: Danish (http://www.transifex.com/sphinx-doc/sphinx-1/language/da/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -3550,12 +3550,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/de/LC_MESSAGES/sphinx.mo b/sphinx/locale/de/LC_MESSAGES/sphinx.mo
index 8c7e02367..0bedad20c 100644
--- a/sphinx/locale/de/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/de/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/de/LC_MESSAGES/sphinx.po b/sphinx/locale/de/LC_MESSAGES/sphinx.po
index 1b71d1b2a..18aeaa1fb 100644
--- a/sphinx/locale/de/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/de/LC_MESSAGES/sphinx.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Jean-François B. <jfbu@free.fr>, 2018\n"
"Language-Team: German (http://www.transifex.com/sphinx-doc/sphinx-1/language/de/)\n"
@@ -3550,12 +3550,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/el/LC_MESSAGES/sphinx.mo b/sphinx/locale/el/LC_MESSAGES/sphinx.mo
index 6280ddc10..89826ca64 100644
--- a/sphinx/locale/el/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/el/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/el/LC_MESSAGES/sphinx.po b/sphinx/locale/el/LC_MESSAGES/sphinx.po
index fc5ca8831..89503e01b 100644
--- a/sphinx/locale/el/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/el/LC_MESSAGES/sphinx.po
@@ -4,15 +4,15 @@
#
# Translators:
# Stelios Vitalis <liberostelios@gmail.com>, 2015
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2021
# tzoumakers tzoumakers <tzoumakersx@gmail.com>, 2019
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>, 2021\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2021\n"
"Language-Team: Greek (http://www.transifex.com/sphinx-doc/sphinx-1/language/el/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -3549,12 +3549,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "άγνωστος τύπος κόμβου: %r"
diff --git a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo
index ba28d2c80..16fe295cc 100644
--- a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po
index e956e4411..168ad7273 100644
--- a/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: English (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_FR/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo
index f4c6472d7..682979cc8 100644
--- a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po
index 58aebc1a0..67e00f82f 100644
--- a/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Adam Turner, 2022\n"
"Language-Team: English (United Kingdom) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_GB/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo
index 488e95999..a7feb4cab 100644
--- a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po
index 1556318d6..562d13321 100644
--- a/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: English (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_HK/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/eo/LC_MESSAGES/sphinx.mo b/sphinx/locale/eo/LC_MESSAGES/sphinx.mo
index 8efb05731..a101e7e6c 100644
--- a/sphinx/locale/eo/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/eo/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/eo/LC_MESSAGES/sphinx.po b/sphinx/locale/eo/LC_MESSAGES/sphinx.po
index e27b1aa42..f46d98326 100644
--- a/sphinx/locale/eo/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/eo/LC_MESSAGES/sphinx.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Tatsuro YOKOTA <hidaruma@outlook.jp>, 2021\n"
"Language-Team: Esperanto (http://www.transifex.com/sphinx-doc/sphinx-1/language/eo/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/es/LC_MESSAGES/sphinx.mo b/sphinx/locale/es/LC_MESSAGES/sphinx.mo
index dbb3a27f0..73a4aec5a 100644
--- a/sphinx/locale/es/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/es/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/es/LC_MESSAGES/sphinx.po b/sphinx/locale/es/LC_MESSAGES/sphinx.po
index a15266c29..a53e5fab5 100644
--- a/sphinx/locale/es/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/es/LC_MESSAGES/sphinx.po
@@ -10,14 +10,14 @@
# Ivan García <ivan.garcia@studio-point.com>, 2019
# Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2013-2018,2020
# Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2022
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016,2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2021
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016,2021\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2021\n"
"Language-Team: Spanish (http://www.transifex.com/sphinx-doc/sphinx-1/language/es/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -3554,12 +3554,12 @@ msgid ""
"not in the domain."
msgstr "Problema en el dominio %s: se supone que el campo debe usar el rol '%s', pero ese rol no está en el dominio."
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "directiva desconocida o nombre de rol: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "tipo de nodo desconocido: %r"
diff --git a/sphinx/locale/et/LC_MESSAGES/sphinx.mo b/sphinx/locale/et/LC_MESSAGES/sphinx.mo
index 10ef2ed7e..178882c77 100644
--- a/sphinx/locale/et/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/et/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/et/LC_MESSAGES/sphinx.po b/sphinx/locale/et/LC_MESSAGES/sphinx.po
index dea03a901..48ec6fd8f 100644
--- a/sphinx/locale/et/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/et/LC_MESSAGES/sphinx.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Ivar Smolin <okul@linux.ee>, 2013-2022\n"
"Language-Team: Estonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/et/)\n"
@@ -3550,12 +3550,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/eu/LC_MESSAGES/sphinx.mo b/sphinx/locale/eu/LC_MESSAGES/sphinx.mo
index 1a08e1263..836058014 100644
--- a/sphinx/locale/eu/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/eu/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/eu/LC_MESSAGES/sphinx.po b/sphinx/locale/eu/LC_MESSAGES/sphinx.po
index c90b91dbe..a4a14bbf0 100644
--- a/sphinx/locale/eu/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/eu/LC_MESSAGES/sphinx.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Asier Iturralde Sarasola <asier.iturralde@gmail.com>, 2018\n"
"Language-Team: Basque (http://www.transifex.com/sphinx-doc/sphinx-1/language/eu/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/fa/LC_MESSAGES/sphinx.mo b/sphinx/locale/fa/LC_MESSAGES/sphinx.mo
index 327affdb2..9f0cae070 100644
--- a/sphinx/locale/fa/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/fa/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/fa/LC_MESSAGES/sphinx.po b/sphinx/locale/fa/LC_MESSAGES/sphinx.po
index 9363f4a1a..2dd79c178 100644
--- a/sphinx/locale/fa/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fa/LC_MESSAGES/sphinx.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Hadi F <h_adi_f@yahoo.com>, 2020-2021\n"
"Language-Team: Persian (http://www.transifex.com/sphinx-doc/sphinx-1/language/fa/)\n"
@@ -3550,12 +3550,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "نام نقش یا دستورالعمل ناشناخته: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "بست از نوع ناشناخته: %r"
diff --git a/sphinx/locale/fi/LC_MESSAGES/sphinx.mo b/sphinx/locale/fi/LC_MESSAGES/sphinx.mo
index 3dd0c56d4..797e5c2c1 100644
--- a/sphinx/locale/fi/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/fi/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/fi/LC_MESSAGES/sphinx.po b/sphinx/locale/fi/LC_MESSAGES/sphinx.po
index 5eaadae5d..2df928216 100644
--- a/sphinx/locale/fi/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fi/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2009\n"
"Language-Team: Finnish (http://www.transifex.com/sphinx-doc/sphinx-1/language/fi/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/fr/LC_MESSAGES/sphinx.mo b/sphinx/locale/fr/LC_MESSAGES/sphinx.mo
index 450ed66e0..001eba3a7 100644
--- a/sphinx/locale/fr/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/fr/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/fr/LC_MESSAGES/sphinx.po b/sphinx/locale/fr/LC_MESSAGES/sphinx.po
index bbeb8fcc2..1f2a397bf 100644
--- a/sphinx/locale/fr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fr/LC_MESSAGES/sphinx.po
@@ -29,12 +29,12 @@
# Olivier Bonaventure <bonaventure@acm.org>, 2019
# Pierre Grépon <pgrepon@yahoo.fr>, 2016
# Sebastien Douche <sdouche@gmail.com>, 2008
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016,2020
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2020
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Jean-François B. <jfbu@free.fr>, 2017-2019,2022\n"
"Language-Team: French (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr/)\n"
@@ -3573,12 +3573,12 @@ msgid ""
"not in the domain."
msgstr "Problème dans le domaine %s : le champ est censé utiliser le rôle '%s', mais ce rôle ne figure pas dans le domaine."
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "nom de rôle ou de directive inconnu: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "type de node inconnu : %r"
diff --git a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo
index c35f76a9a..62f5f0d18 100644
--- a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po
index 89f3f6d26..e131ce932 100644
--- a/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: French (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr_FR/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/he/LC_MESSAGES/sphinx.mo b/sphinx/locale/he/LC_MESSAGES/sphinx.mo
index 7483aa766..4b285044b 100644
--- a/sphinx/locale/he/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/he/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/he/LC_MESSAGES/sphinx.po b/sphinx/locale/he/LC_MESSAGES/sphinx.po
index 6ba7fa8bd..848a18799 100644
--- a/sphinx/locale/he/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/he/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2011\n"
"Language-Team: Hebrew (http://www.transifex.com/sphinx-doc/sphinx-1/language/he/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/hi/LC_MESSAGES/sphinx.mo b/sphinx/locale/hi/LC_MESSAGES/sphinx.mo
index 7ff8f2187..56eee6eff 100644
--- a/sphinx/locale/hi/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/hi/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/hi/LC_MESSAGES/sphinx.po b/sphinx/locale/hi/LC_MESSAGES/sphinx.po
index 12da408e4..7ee5ed5fb 100644
--- a/sphinx/locale/hi/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hi/LC_MESSAGES/sphinx.po
@@ -6,12 +6,12 @@
# Ajay Singh <ajaysajay@gmail.com>, 2019
# Purnank H. Ghumalia <me@purnank.in>, 2015-2016
# Sumanjali Damarla <damarlasumanjali@gmail.com>, 2020
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2019
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2019
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Sumanjali Damarla <damarlasumanjali@gmail.com>, 2020\n"
"Language-Team: Hindi (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi/)\n"
@@ -3550,12 +3550,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "अज्ञात बिंदु प्रकार: %r"
diff --git a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo
index 7f5597e52..356b3991f 100644
--- a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po
index 76f39b4c4..2201c3f3b 100644
--- a/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Hindi (India) (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi_IN/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/hr/LC_MESSAGES/sphinx.mo b/sphinx/locale/hr/LC_MESSAGES/sphinx.mo
index 7f3dbdca7..53e21ca86 100644
--- a/sphinx/locale/hr/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/hr/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/hr/LC_MESSAGES/sphinx.po b/sphinx/locale/hr/LC_MESSAGES/sphinx.po
index dbe2cd8d9..459c4ac4b 100644
--- a/sphinx/locale/hr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hr/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Mario Šarić, 2015-2020\n"
"Language-Team: Croatian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hr/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/hu/LC_MESSAGES/sphinx.mo b/sphinx/locale/hu/LC_MESSAGES/sphinx.mo
index d6557d2be..b47add139 100644
--- a/sphinx/locale/hu/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/hu/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/hu/LC_MESSAGES/sphinx.po b/sphinx/locale/hu/LC_MESSAGES/sphinx.po
index 6425e4417..28c1e85cf 100644
--- a/sphinx/locale/hu/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/hu/LC_MESSAGES/sphinx.po
@@ -13,7 +13,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Balázs Úr, 2020\n"
"Language-Team: Hungarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hu/)\n"
@@ -3552,12 +3552,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/id/LC_MESSAGES/sphinx.mo b/sphinx/locale/id/LC_MESSAGES/sphinx.mo
index 62f09ce1d..6188ade9a 100644
--- a/sphinx/locale/id/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/id/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/id/LC_MESSAGES/sphinx.po b/sphinx/locale/id/LC_MESSAGES/sphinx.po
index ab5f03dab..066d0e278 100644
--- a/sphinx/locale/id/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/id/LC_MESSAGES/sphinx.po
@@ -12,7 +12,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: oon arfiandwi <oon.arfiandwi@gmail.com>, 2019-2020\n"
"Language-Team: Indonesian (http://www.transifex.com/sphinx-doc/sphinx-1/language/id/)\n"
@@ -3551,12 +3551,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "tipe simpul tidak dikenal: %r"
diff --git a/sphinx/locale/is/LC_MESSAGES/sphinx.mo b/sphinx/locale/is/LC_MESSAGES/sphinx.mo
index d0f2b7360..c55b735e1 100644
--- a/sphinx/locale/is/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/is/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/is/LC_MESSAGES/sphinx.po b/sphinx/locale/is/LC_MESSAGES/sphinx.po
index 19b2c6628..cf1e9a894 100644
--- a/sphinx/locale/is/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/is/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Tryggvi Kalman <tkj3@hi.is>, 2021\n"
"Language-Team: Icelandic (http://www.transifex.com/sphinx-doc/sphinx-1/language/is/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/it/LC_MESSAGES/sphinx.mo b/sphinx/locale/it/LC_MESSAGES/sphinx.mo
index d16f07e92..df0dd1787 100644
--- a/sphinx/locale/it/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/it/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/it/LC_MESSAGES/sphinx.po b/sphinx/locale/it/LC_MESSAGES/sphinx.po
index f5629174e..f8f8ada1d 100644
--- a/sphinx/locale/it/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/it/LC_MESSAGES/sphinx.po
@@ -8,12 +8,12 @@
# Paolo Cavallini <cavallini@faunalia.it>, 2013-2017
# Roland Puntaier <roland.puntaier@chello.at>, 2013
# Sandro Dentella <sandro@e-den.it>, 2008
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Antonari Palmio, 2022\n"
"Language-Team: Italian (http://www.transifex.com/sphinx-doc/sphinx-1/language/it/)\n"
@@ -3552,12 +3552,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/ja/LC_MESSAGES/sphinx.mo b/sphinx/locale/ja/LC_MESSAGES/sphinx.mo
index 85d6eb543..6f5c9ef9d 100644
--- a/sphinx/locale/ja/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ja/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ja/LC_MESSAGES/sphinx.po b/sphinx/locale/ja/LC_MESSAGES/sphinx.po
index 3a67d9010..a8c0ed13d 100644
--- a/sphinx/locale/ja/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ja/LC_MESSAGES/sphinx.po
@@ -8,15 +8,15 @@
# tomo, 2018
# Hisahiro Ohmura, 2017
# KaKkouo, 2021
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2021
# Kouhei Sutou <kou@clear-code.com>, 2011
# sutefu7, 2019-2020
# shirou - しろう <shirou.faw@gmail.com>, 2017
# Taizo Ito <taizo.ito@hennge.com>, 2019
# Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>, 2013-2016
# Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>, 2016-2017,2019
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016-2017,2019,2022
-# Tetsuo Koyama <tkoyama010@gmail.com>, 2020-2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016-2017,2019,2022
+# Tetsuo Koyama <tkoyama010@gmail.com>, 2020-2022
# tomo, 2019
# shirou - しろう <shirou.faw@gmail.com>, 2014
# Yasushi Masuda <whosaysni@gmail.com>, 2008
@@ -24,9 +24,9 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016-2017,2019,2022\n"
+"Last-Translator: Tetsuo Koyama <tkoyama010@gmail.com>, 2020-2022\n"
"Language-Team: Japanese (http://www.transifex.com/sphinx-doc/sphinx-1/language/ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -191,7 +191,7 @@ msgstr "conf.py が設定ディレクトリに存在しません (%s)"
msgid ""
"Invalid configuration value found: 'language = None'. Update your "
"configuration to a valid language code. Falling back to 'en' (English)."
-msgstr ""
+msgstr "無効な設定値が見つかりました: 'language = None' 。設定を有効な言語コードに更新してください。 'en' (英語)にフォールバックしています。"
#: sphinx/config.py:202
#, python-format
@@ -484,12 +484,12 @@ msgstr "Python Enhancement Proposals; PEP %s"
#: sphinx/roles.py:188
#, python-format
msgid "invalid PEP number %s"
-msgstr ""
+msgstr "無効なPEP番号 %s"
#: sphinx/roles.py:222
#, python-format
msgid "invalid RFC number %s"
-msgstr ""
+msgstr "無効なRFC番号 %s"
#: sphinx/theming.py:72
#, python-format
@@ -1243,7 +1243,7 @@ msgid ""
"\n"
"By default, everything that is outdated is built. Output only for selected\n"
"files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\nソースファイルからドキュメントを生成します。\n\nsphinx-build は、SOURCEDIR 内のファイルをもとにドキュメントを生成し、\nOUTPUTDIR 内に配置します。またコンフィグ\n設定用に SOURCEDIR 内から\n 'conf.py' を探します。'sphinx-quickstart' ツールを使うと\n 'conf.py' を含むテンプレートファイルを生成することができます。\n\nsphinx-build は、さまざまな形式のドキュメントを作成することができます。フォーマットは、\nコマンドラインでビルダー名を指定して選択します。デフォルトは\nHTML です。ビルダーはドキュメント化処理に関連した他のタスクも実行できます。\n\nデフォルトでは、古いものはすべてビルドされています。個別にファイル名を指定することで、\n選択したファイルのみ出力することもできます。\n"
#: sphinx/cmd/build.py:120
msgid "path to documentation source files"
@@ -1516,7 +1516,7 @@ msgid ""
"Python the version is something like 2.5 or 3.0, while the release is\n"
"something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
"just set both to the same value."
-msgstr ""
+msgstr "Sphinx には、ソフトウェアに対して \"バージョン\" と \"リリース\" という概念が\nあります。各バージョンは複数のリリースを持つことができます。\n例えば、Python だとバージョンが 2.5 や 3.0 のように分かれているように、\nリリースも 2.5.1 や 3.0a1 のように分けて持つことができます。もしこのような多重構成が必要ない場合は、\n両方を同じ値に設定するだけです。"
#: sphinx/cmd/quickstart.py:259
msgid "Project version"
@@ -3563,12 +3563,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "不明なディレクティブまたはロール名: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "不明なノードタイプ: %r"
@@ -3632,7 +3632,7 @@ msgstr "この用語の解説へ"
#: sphinx/writers/html.py:428 sphinx/writers/html.py:433
#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
msgid "Permalink to this heading"
-msgstr ""
+msgstr "この見出しへのパーマリンク"
#: sphinx/writers/html.py:437 sphinx/writers/html5.py:396
msgid "Permalink to this table"
diff --git a/sphinx/locale/ko/LC_MESSAGES/sphinx.mo b/sphinx/locale/ko/LC_MESSAGES/sphinx.mo
index 239fc406e..af1a83063 100644
--- a/sphinx/locale/ko/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ko/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ko/LC_MESSAGES/sphinx.po b/sphinx/locale/ko/LC_MESSAGES/sphinx.po
index 7ba89147b..9197d1d4e 100644
--- a/sphinx/locale/ko/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ko/LC_MESSAGES/sphinx.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: YT H <dev@theYT.net>, 2019-2022\n"
"Language-Team: Korean (http://www.transifex.com/sphinx-doc/sphinx-1/language/ko/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr "%s 영역에서 문제 발생: 필드가 '%s' 역할을 사용해야 하지만, 해당 역할이 도메인에 없습니다."
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "알 수 없는 지시문 또는 역할 이름: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "알 수 없는 노드 유형: %r"
diff --git a/sphinx/locale/lt/LC_MESSAGES/sphinx.mo b/sphinx/locale/lt/LC_MESSAGES/sphinx.mo
index 0662e6b14..76e262623 100644
--- a/sphinx/locale/lt/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/lt/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/lt/LC_MESSAGES/sphinx.po b/sphinx/locale/lt/LC_MESSAGES/sphinx.po
index 437f498c5..685673526 100644
--- a/sphinx/locale/lt/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/lt/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: DALIUS DOBRAVOLSKAS <DALIUS@SANDBOX.LT>, 2010\n"
"Language-Team: Lithuanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lt/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/lv/LC_MESSAGES/sphinx.mo b/sphinx/locale/lv/LC_MESSAGES/sphinx.mo
index ac5fda135..d34b0cdea 100644
--- a/sphinx/locale/lv/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/lv/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/lv/LC_MESSAGES/sphinx.po b/sphinx/locale/lv/LC_MESSAGES/sphinx.po
index a52d93476..9cad57217 100644
--- a/sphinx/locale/lv/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/lv/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Latvian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lv/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/mk/LC_MESSAGES/sphinx.mo b/sphinx/locale/mk/LC_MESSAGES/sphinx.mo
index bbff1a0a0..62e7a2f48 100644
--- a/sphinx/locale/mk/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/mk/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/mk/LC_MESSAGES/sphinx.po b/sphinx/locale/mk/LC_MESSAGES/sphinx.po
index 18fc981ef..a4a211898 100644
--- a/sphinx/locale/mk/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/mk/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Vasil Vangelovski <vvangelovski@gmail.com>, 2013\n"
"Language-Team: Macedonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/mk/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo
index 3c0b82c04..13770d81d 100644
--- a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
index c1153daeb..5df03e772 100644
--- a/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Norwegian Bokmål (Norway) (http://www.transifex.com/sphinx-doc/sphinx-1/language/nb_NO/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/ne/LC_MESSAGES/sphinx.mo b/sphinx/locale/ne/LC_MESSAGES/sphinx.mo
index a1d0e1fa8..156b08a70 100644
--- a/sphinx/locale/ne/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ne/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ne/LC_MESSAGES/sphinx.po b/sphinx/locale/ne/LC_MESSAGES/sphinx.po
index 2a17068b1..c78810752 100644
--- a/sphinx/locale/ne/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ne/LC_MESSAGES/sphinx.po
@@ -4,14 +4,14 @@
#
# Translators:
# FIRST AUTHOR <EMAIL@ADDRESS>, 2011
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2016\n"
"Language-Team: Nepali (http://www.transifex.com/sphinx-doc/sphinx-1/language/ne/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/nl/LC_MESSAGES/sphinx.mo b/sphinx/locale/nl/LC_MESSAGES/sphinx.mo
index ee90eb7f7..3c31c215f 100644
--- a/sphinx/locale/nl/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/nl/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/nl/LC_MESSAGES/sphinx.po b/sphinx/locale/nl/LC_MESSAGES/sphinx.po
index 4fd7b6f27..ded2a3d5e 100644
--- a/sphinx/locale/nl/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/nl/LC_MESSAGES/sphinx.po
@@ -9,14 +9,14 @@
# FIRST AUTHOR <EMAIL@ADDRESS>, 2008
# Gert van Dijk <gertvdijk@gmail.com>, 2019
# Jesse Tan, 2017
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2021
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>, 2021\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2021\n"
"Language-Team: Dutch (http://www.transifex.com/sphinx-doc/sphinx-1/language/nl/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -3553,12 +3553,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/pl/LC_MESSAGES/sphinx.mo b/sphinx/locale/pl/LC_MESSAGES/sphinx.mo
index d527aab9a..a330cc482 100644
--- a/sphinx/locale/pl/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/pl/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/pl/LC_MESSAGES/sphinx.po b/sphinx/locale/pl/LC_MESSAGES/sphinx.po
index 0eca7aafd..2e92a7561 100644
--- a/sphinx/locale/pl/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pl/LC_MESSAGES/sphinx.po
@@ -5,13 +5,13 @@
# Translators:
# Maciej Olko <maciej.olko@gmail.com>, 2017-2020
# Michael Gielda <michal.gielda@gmail.com>, 2014
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2018
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2018
# Tawez, 2013-2019
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Maciej Olko <maciej.olko@gmail.com>, 2017-2020\n"
"Language-Team: Polish (http://www.transifex.com/sphinx-doc/sphinx-1/language/pl/)\n"
@@ -3550,12 +3550,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/pt/LC_MESSAGES/sphinx.mo b/sphinx/locale/pt/LC_MESSAGES/sphinx.mo
index b6e2a1019..c11d7e621 100644
--- a/sphinx/locale/pt/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/pt/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/pt/LC_MESSAGES/sphinx.po b/sphinx/locale/pt/LC_MESSAGES/sphinx.po
index 4698f1f2a..1e05ad131 100644
--- a/sphinx/locale/pt/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pt/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Portuguese (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo
index 4f26948ea..453df7774 100644
--- a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po
index d2d8ca2af..943d0b734 100644
--- a/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po
@@ -8,12 +8,12 @@
# gilberto dos santos alves <gsavix@gmail.com>, 2015-2016
# Rafael Fontenelle <rafaelff@gnome.org>, 2019
# Rafael Fontenelle <rffontenelle@gmail.com>, 2019-2022
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2019-2022\n"
"Language-Team: Portuguese (Brazil) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_BR/)\n"
@@ -3552,12 +3552,12 @@ msgid ""
"not in the domain."
msgstr "Problema no domínio %s: o campo deveria usar o papel \"%s\", mas esse papel não está no domínio."
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "diretiva ou nome de papel desconhecida(o): %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "tipo de nó desconhecido: %r"
diff --git a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo
index 105347f3b..600b5d78f 100644
--- a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po
index db0e17094..b9148bc00 100644
--- a/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po
@@ -4,14 +4,14 @@
#
# Translators:
# Pedro Algarvio <pedro@algarvio.me>, 2013
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
-"Last-Translator: Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2016\n"
"Language-Team: Portuguese (Portugal) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_PT/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/ro/LC_MESSAGES/sphinx.mo b/sphinx/locale/ro/LC_MESSAGES/sphinx.mo
index f564d6cec..0194bef02 100644
--- a/sphinx/locale/ro/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ro/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ro/LC_MESSAGES/sphinx.po b/sphinx/locale/ro/LC_MESSAGES/sphinx.po
index e6c8ec41a..75ffc5c7b 100644
--- a/sphinx/locale/ro/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ro/LC_MESSAGES/sphinx.po
@@ -4,12 +4,12 @@
#
# Translators:
# Razvan Stefanescu <razvan.stefanescu@gmail.com>, 2015-2017
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Razvan Stefanescu <razvan.stefanescu@gmail.com>, 2015-2017\n"
"Language-Team: Romanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ro/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/ru/LC_MESSAGES/sphinx.mo b/sphinx/locale/ru/LC_MESSAGES/sphinx.mo
index a053cda42..4f8e77021 100644
--- a/sphinx/locale/ru/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ru/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ru/LC_MESSAGES/sphinx.po b/sphinx/locale/ru/LC_MESSAGES/sphinx.po
index 1b515fa79..3a3dd06ce 100644
--- a/sphinx/locale/ru/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ru/LC_MESSAGES/sphinx.po
@@ -14,7 +14,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Il'ya <ilya@marshal.dev>, 2022\n"
"Language-Team: Russian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ru/)\n"
@@ -3553,12 +3553,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/si/LC_MESSAGES/sphinx.mo b/sphinx/locale/si/LC_MESSAGES/sphinx.mo
index 79b9fff27..8d86a7a9f 100644
--- a/sphinx/locale/si/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/si/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/si/LC_MESSAGES/sphinx.po b/sphinx/locale/si/LC_MESSAGES/sphinx.po
index 238d2ca66..e912da99b 100644
--- a/sphinx/locale/si/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/si/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: callkalpa <callkalpa@gmail.com>, 2013\n"
"Language-Team: Sinhala (http://www.transifex.com/sphinx-doc/sphinx-1/language/si/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/sk/LC_MESSAGES/sphinx.mo b/sphinx/locale/sk/LC_MESSAGES/sphinx.mo
index 5d6f4663c..1054a0b5b 100644
--- a/sphinx/locale/sk/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/sk/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/sk/LC_MESSAGES/sphinx.po b/sphinx/locale/sk/LC_MESSAGES/sphinx.po
index 3bf28889b..1a3d910d8 100644
--- a/sphinx/locale/sk/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sk/LC_MESSAGES/sphinx.po
@@ -5,12 +5,12 @@
# Translators:
# FIRST AUTHOR <EMAIL@ADDRESS>, 2008
# Slavko <linux@slavino.sk>, 2013-2019,2021
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2016
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016
msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Slavko <linux@slavino.sk>, 2013-2019,2021\n"
"Language-Team: Slovak (http://www.transifex.com/sphinx-doc/sphinx-1/language/sk/)\n"
@@ -3549,12 +3549,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "neznáma direktíva alebo meno role: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "neznámy typ uzla: %r"
diff --git a/sphinx/locale/sl/LC_MESSAGES/sphinx.mo b/sphinx/locale/sl/LC_MESSAGES/sphinx.mo
index 5e8a210f7..d1f2c5d7e 100644
--- a/sphinx/locale/sl/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/sl/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/sl/LC_MESSAGES/sphinx.po b/sphinx/locale/sl/LC_MESSAGES/sphinx.po
index 8b6664e43..8a3f100a2 100644
--- a/sphinx/locale/sl/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sl/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Slovenian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sl/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/sphinx.pot b/sphinx/locale/sphinx.pot
index 7c13d932c..d7b391aa1 100644
--- a/sphinx/locale/sphinx.pot
+++ b/sphinx/locale/sphinx.pot
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx 5.1.0\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -3567,12 +3567,12 @@ msgid ""
"is not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/sq/LC_MESSAGES/sphinx.mo b/sphinx/locale/sq/LC_MESSAGES/sphinx.mo
index d02564409..14c3762fc 100644
--- a/sphinx/locale/sq/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/sq/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/sq/LC_MESSAGES/sphinx.po b/sphinx/locale/sq/LC_MESSAGES/sphinx.po
index c6f256c0b..1df813528 100644
--- a/sphinx/locale/sq/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sq/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Besnik Bleta <besnik@programeshqip.org>, 2021-2022\n"
"Language-Team: Albanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sq/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr "Problem në përkatësinë %s: fusha supozohet të përdorë rol '%s', por ai rol s’gjendet te përkatësia."
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "emër direktive ose roli të panjohur: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "lloj i panjohur nyjeje: %r"
diff --git a/sphinx/locale/sr/LC_MESSAGES/sphinx.mo b/sphinx/locale/sr/LC_MESSAGES/sphinx.mo
index e8ee7749f..4041b257b 100644
--- a/sphinx/locale/sr/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/sr/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/sr/LC_MESSAGES/sphinx.po b/sphinx/locale/sr/LC_MESSAGES/sphinx.po
index b2c4c2d27..b87386739 100644
--- a/sphinx/locale/sr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sr/LC_MESSAGES/sphinx.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Vladimir Milovanović <vmilovanovic@gmail.com>, 2020\n"
"Language-Team: Serbian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr/)\n"
@@ -3548,12 +3548,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo
index 9879271ee..2715bd6fc 100644
--- a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po
index 3f413bb48..fb99edbb3 100644
--- a/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Serbian (Latin) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr@latin/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo
index 08106cdd7..ebfd3e6d7 100644
--- a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po
index 48b3405ca..ce80c405a 100644
--- a/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Serbian (Serbia) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr_RS/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/sv/LC_MESSAGES/sphinx.mo b/sphinx/locale/sv/LC_MESSAGES/sphinx.mo
index 42084d183..472f206fe 100644
--- a/sphinx/locale/sv/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/sv/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/sv/LC_MESSAGES/sphinx.po b/sphinx/locale/sv/LC_MESSAGES/sphinx.po
index ec2e9fe2e..1c2bf6a92 100644
--- a/sphinx/locale/sv/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/sv/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Swedish (http://www.transifex.com/sphinx-doc/sphinx-1/language/sv/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/ta/LC_MESSAGES/sphinx.mo b/sphinx/locale/ta/LC_MESSAGES/sphinx.mo
index 0010bc682..1318a17ae 100644
--- a/sphinx/locale/ta/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ta/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ta/LC_MESSAGES/sphinx.po b/sphinx/locale/ta/LC_MESSAGES/sphinx.po
index 468194de6..154da4abb 100644
--- a/sphinx/locale/ta/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ta/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Julien Malard <julien.malard@mail.mcgill.ca>, 2019\n"
"Language-Team: Tamil (http://www.transifex.com/sphinx-doc/sphinx-1/language/ta/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/te/LC_MESSAGES/sphinx.mo b/sphinx/locale/te/LC_MESSAGES/sphinx.mo
index c378aa41a..c47ba67a0 100644
--- a/sphinx/locale/te/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/te/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/te/LC_MESSAGES/sphinx.po b/sphinx/locale/te/LC_MESSAGES/sphinx.po
index dc1a9b26b..3bdbc4634 100644
--- a/sphinx/locale/te/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/te/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Telugu (http://www.transifex.com/sphinx-doc/sphinx-1/language/te/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/tr/LC_MESSAGES/sphinx.mo b/sphinx/locale/tr/LC_MESSAGES/sphinx.mo
index c20f4637d..6d5f1364d 100644
--- a/sphinx/locale/tr/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/tr/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/tr/LC_MESSAGES/sphinx.po b/sphinx/locale/tr/LC_MESSAGES/sphinx.po
index b8f2a642c..eecededfa 100644
--- a/sphinx/locale/tr/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/tr/LC_MESSAGES/sphinx.po
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: BouRock, 2020\n"
"Language-Team: Turkish (http://www.transifex.com/sphinx-doc/sphinx-1/language/tr/)\n"
@@ -3550,12 +3550,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo
index aaf19bb97..871d643cb 100644
--- a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
index 4f44aaa0b..73cbfe53d 100644
--- a/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Petro Sasnyk <petro@sasnyk.name>, 2009\n"
"Language-Team: Ukrainian (Ukraine) (http://www.transifex.com/sphinx-doc/sphinx-1/language/uk_UA/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/ur/LC_MESSAGES/sphinx.mo b/sphinx/locale/ur/LC_MESSAGES/sphinx.mo
index 046da2636..683cc95c1 100644
--- a/sphinx/locale/ur/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/ur/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/ur/LC_MESSAGES/sphinx.po b/sphinx/locale/ur/LC_MESSAGES/sphinx.po
index 9fdb33272..fba592267 100644
--- a/sphinx/locale/ur/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/ur/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Urdu (http://www.transifex.com/sphinx-doc/sphinx-1/language/ur/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/vi/LC_MESSAGES/sphinx.mo b/sphinx/locale/vi/LC_MESSAGES/sphinx.mo
index 130a8aed8..536695904 100644
--- a/sphinx/locale/vi/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/vi/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/vi/LC_MESSAGES/sphinx.po b/sphinx/locale/vi/LC_MESSAGES/sphinx.po
index 7ba104ae2..094d9feaa 100644
--- a/sphinx/locale/vi/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/vi/LC_MESSAGES/sphinx.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Hoat Le Van <hoatlevan@gmail.com>, 2014\n"
"Language-Team: Vietnamese (http://www.transifex.com/sphinx-doc/sphinx-1/language/vi/)\n"
@@ -3547,12 +3547,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/yue/LC_MESSAGES/sphinx.mo b/sphinx/locale/yue/LC_MESSAGES/sphinx.mo
index f35d1b390..44af9cd53 100644
--- a/sphinx/locale/yue/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/yue/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/yue/LC_MESSAGES/sphinx.po b/sphinx/locale/yue/LC_MESSAGES/sphinx.po
index c8f99115b..5be3181a1 100644
--- a/sphinx/locale/yue/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/yue/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Cantonese (http://www.transifex.com/sphinx-doc/sphinx-1/language/yue/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo
index 48ed84e70..9bb251c6c 100644
--- a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po
index 5381807b4..00d976ec4 100644
--- a/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po
@@ -15,7 +15,7 @@
# Lu <lu2github@gmail.com>, 2022
# Nomaka <nomakacyx@gmail.com>, 2018,2022
# Ryekee Zhong <ryekee@gmail.com>, 2013
-# Takeshi KOMIYA <i.tkomiya@gmail.com>, 2019,2021-2022
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2019,2021-2022
# Tower Joo<zhutao.iscas@gmail.com>, 2009
# wendi cao <651645601@qq.com>, 2020
# Yinian Chin <yinian1992@live.com>, 2013,2018,2020,2022
@@ -24,7 +24,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Yinian Chin <yinian1992@live.com>, 2013,2018,2020,2022\n"
"Language-Team: Chinese (China) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_CN/)\n"
@@ -3563,12 +3563,12 @@ msgid ""
"not in the domain."
msgstr "%s 域中的问题:字段应采用“%s”角色,但域中并不包含该角色。"
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "未知的指令或角色名称:%s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "未知节点类型:%r"
diff --git a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo
index 46a237917..f14f69e12 100644
--- a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po
index 04d89e877..5e297f54a 100644
--- a/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Chinese (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_HK/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo
index 9a0e27d53..0794458ea 100644
--- a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po
index f6642cd66..e6446973b 100644
--- a/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Chinese (Taiwan) (Big5) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW.Big5/)\n"
@@ -3546,12 +3546,12 @@ msgid ""
"not in the domain."
msgstr ""
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr ""
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr ""
diff --git a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo
index 5e7f68554..ea76e971d 100644
--- a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo
+++ b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo
Binary files differ
diff --git a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po
index 44b8dfbca..e4f7f03a5 100644
--- a/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po
+++ b/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po
@@ -15,7 +15,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-07-03 00:22+0000\n"
+"POT-Creation-Date: 2022-07-10 00:23+0000\n"
"PO-Revision-Date: 2013-04-02 08:44+0000\n"
"Last-Translator: Steven Hsu <hsuhaochun@gmail.com>, 2021-2022\n"
"Language-Team: Chinese (Taiwan) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW/)\n"
@@ -3554,12 +3554,12 @@ msgid ""
"not in the domain."
msgstr "在 %s domain 中的問題:欄位應該要用角色 '%s' ,但是那個角色並不在該 domain。"
-#: sphinx/util/docutils.py:256
+#: sphinx/util/docutils.py:293
#, python-format
msgid "unknown directive or role name: %s:%s"
msgstr "未知的指令或角色名稱: %s:%s"
-#: sphinx/util/docutils.py:549
+#: sphinx/util/docutils.py:586
#, python-format
msgid "unknown node type: %r"
msgstr "未知的節點型別: %r"
diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty
index b67722c1b..9b0b54c56 100644
--- a/sphinx/texinputs/sphinx.sty
+++ b/sphinx/texinputs/sphinx.sty
@@ -74,6 +74,7 @@
% dimensions, we declare the \dimen registers here.
\newdimen\sphinxverbatimsep
\newdimen\sphinxverbatimborder
+\newdimen\sphinxverbatimradius
\newdimen\sphinxshadowsep
\newdimen\sphinxshadowsize
\newdimen\sphinxshadowrule
@@ -87,6 +88,12 @@
\define@key{sphinx}{verbatimsep}{\sphinxverbatimsep\dimexpr #1\relax}
\sphinxverbatimborder=\fboxrule
\define@key{sphinx}{verbatimborder}{\sphinxverbatimborder\dimexpr #1\relax}
+\sphinxverbatimradius=0pt
+ \define@key{sphinx}{verbatimradius}{%
+ \sphinxverbatimradius\dimexpr #1\relax
+ \ifdim\sphinxverbatimradius=\z@\else\RequirePackage{sphinxpackageboxes}\fi
+ }
+\AtBeginDocument{\define@key{sphinx}{verbatimradius}{\sphinxverbatimradius\dimexpr #1\relax}}
% topic boxes
\sphinxshadowsep =5pt
\define@key{sphinx}{shadowsep}{\sphinxshadowsep\dimexpr #1\relax}
@@ -274,6 +281,9 @@
\input{sphinxlatexadmonitions.sty}
\input{sphinxlatexliterals.sty}
\input{sphinxlatexshadowbox.sty}
+\ifdim\sphinxverbatimradius=\z@\else
+ \RequirePackage{sphinxpackageboxes}
+\fi
%% CONTAINERS
diff --git a/sphinx/texinputs/sphinxlatexliterals.sty b/sphinx/texinputs/sphinxlatexliterals.sty
index aa907333f..b4eb39174 100644
--- a/sphinx/texinputs/sphinxlatexliterals.sty
+++ b/sphinx/texinputs/sphinxlatexliterals.sty
@@ -103,91 +103,93 @@
% - attach non-detachable continuation hints above/below frame
% - draw the frame and fill the background color in a manner avoiding
% problems in some pdf viewers
-% - (most recent change, very TeXnical; relates: #8686) work around
-% some potential color issues when a very long code line is wrapped
-% and then encounters a page break while in the middle of colored text
-% (cf \spx@verb@@PreProcessLine). Turns out this was related to hard
-% coded behaviour of internal color.sty/xcolor.sty macros.
-\let\spx@original@set@color\set@color
+% - do background coloring differently from color.sty/xcolor.sty macros
+% (even core internal ones) to work around issues at page breaks
+% as the framed contents are split into chunks with possibly unpaired
+% "color push" or "color pop"
% About the produced output:
% - it obeys current indentation,
-% - frame of width \fboxrule is \fboxsep-separated from the contents,
-% - the contents use the full available text width,
-% - #1 = color of frame, #2 = color of background,
-% - #3 = will be typeset above frame, in a non detachable way,
-% - #4 = will be typeset below frame, in a non detachable way,
-% - #5 = will be typeset within frame,
-% #3 and #4 are expected to be already typeset \hbox'es.
-% #5 are the contents, and in the context of usage of fancyvrb+framed by
-% Sphinx, it will arrive here already transformed into horizontal boxes,
-% as well as some interline penalties and glues.
-\long\def\spx@fcolorbox #1#2#3#4#5{%
+% - frame of width \sphinxverbatimborder is \sphinxverbatimsep -arated
+% from the contents,
+% - the contents use the full available text width, limited by indentation,
+% - #1 = will be typeset above frame, in a non detachable way,
+% - #2 = will be typeset below frame, in a non detachable way,
+% - #3 = will be typeset within the frame.
+% #1 and #2 are expected to be already typeset \hbox'es.
+% #3 are the contents, and in the context of usage of fancyvrb+framed,
+% it will arrive here already transformed into horizontal boxes,
+% interline penalties and glues.
+\long\def\spx@verb@FrameCommand #1#2#3{%
+ % These \hskips are for fancyvrb.sty measuring and will make the
+ % framing "adapt" to an indented context.
+ \ifspx@opt@verbatimwithframe\else\sphinxverbatimborder\z@\fi
\hskip\@totalleftmargin
- \hskip-\fboxsep\hskip-\fboxrule
- % MEMO: this code is modified from color.sty's \color@b@x which has some
- % features making it problematic when #5, as will be here the case in the
- % context of usage of fancyvrb+framed+\spx@verb@@PreProcessLine may contain
- % an unbalanced "color push". We must avoid an extra "color pop" located at
- % a page break location. For this reason we do not add a \set@color or
- % \normalcolor at start of #5.
- \setbox\z@\hbox{\kern\fboxsep{#5}\kern\fboxsep}%
- \dimen@\ht\z@ \advance\dimen@\fboxsep \ht\z@\dimen@
- \dimen@\dp\z@ \advance\dimen@\fboxsep \dp\z@\dimen@
- % \spx@CustomFbox uses already scope-limiting group, no need for one more
- \spx@CustomFBox{#1}% frame color
- {#3}% above frame, already a box
- {#4}% below frame, already a box
- {\def\set@color{\let\set@color\spx@original@set@color}%
- \color{#2}% above trick avoids a color pop *after* \box\z@
- % MEMO: it is very very improbable that \color/\color@block
- % will ever change (even if we raised some ticket at
- % their issue tracker), but if they do, perhaps a
- % change here could be needed in some distant future.
- % MEMO: the \color@block "push + pop" happens *before* \box\z@
- \color@block{\wd\z@}{\ht\z@}{\dp\z@}%
- \box\z@}%
- \hskip-\fboxsep\hskip-\fboxrule
+ \hskip-\sphinxverbatimsep\hskip-\sphinxverbatimborder
+ \spx@verb@fcolorbox {#1}{#2}{#3}%
+ \hskip-\sphinxverbatimsep\hskip-\sphinxverbatimborder
\hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth
}%
-% #1 = color of frame
-% #2 = for material above frame, such as a caption or a "continued" hint
-% #3 = for material below frame, such as a caption or "continues on next page"
-% #4 = contents; or rather if called from \spx@fcolorbox (only supported use
-% case here), the contents are in \box\z@ and #4 are the instructions to
-% "fill background color then draw contents \box\z@"
-\long\def\spx@CustomFBox#1#2#3#4{%
- \begingroup
- % formerly, we used \@tempboxa, but let's use private box for maximal safety
- \setbox\spx@verb@tempboxa\hbox{#4}% no (more) need for extra grouping (now)
- \vbox{#2% above frame
+\long\def\spx@verb@fcolorbox #1#2#3{%
+ % MEMO: in the context of framed.sty this will always expand inside some
+ % \hbox isolated from other code, so we can use \box\z@, \box\tw@,...
+ % with no need of extra group.
+%
+ % MEMO: this code was originally using \color@b@x but the latter has
+ % problematic features regarding color in a context like here where #3
+ % may contain an unbalanced "color push".
+%
+ % MEMO: Some PDF viewers have (or had) issues when the external frame is
+ % drawn first, then the background color is added. So we will draw first
+ % the background color (and let it extend to the frame area) then, hence
+ % on top of it the frame. And we draw the contents latest.
+%
+ % TODO: add top right bottom left padding possibilities.
+ % Prepare a box with the contents and reserved space for framing.
+ \setbox\z@\hbox{\kern\dimexpr\sphinxverbatimborder+\sphinxverbatimsep\relax
+ {#3}\kern\dimexpr\sphinxverbatimborder+\sphinxverbatimsep\relax}%
+ \ht\z@ \dimexpr\ht\z@+\sphinxverbatimsep+\sphinxverbatimborder\relax
+ \dp\z@ \dimexpr\dp\z@+\sphinxverbatimsep+\sphinxverbatimborder\relax
+ % Prepare colored background
+ \setbox\tw@\hbox{{\color{VerbatimColor}\vrule\@width\wd\z@\@height\ht\z@\@depth\dp\z@}}%
+ \vbox{#1% continuation hint attached above frame
% draw frame border _latest_ to avoid pdf viewer issue
% be careful not to cause "color push + contents + color pop"
- \kern\fboxrule
- \hbox{\kern\fboxrule
- \copy\spx@verb@tempboxa% \copy to keep \wd, \dp, \ht for later
- {\color{#1}% frame color
- \kern-\wd\spx@verb@tempboxa\kern-\fboxrule
- \vrule\@width\fboxrule
- \kern\wd\spx@verb@tempboxa
- \vrule\@width\fboxrule}%
- }%
- {\color{#1}% frame color
- \kern-\dimexpr\ht\spx@verb@tempboxa+\dp\spx@verb@tempboxa+\fboxrule\relax
- \hrule\@height\fboxrule
- \kern\dimexpr\ht\spx@verb@tempboxa+\dp\spx@verb@tempboxa\relax
- \hrule\@height\fboxrule}%
- #3% below frame
- }%
- \endgroup
+ % there will be a small "\lineskip" space here from TeX
+ % the colored background
+ \copy\tw@
+ % stroke the frame
+ \kern-\dimexpr\ht\tw@+\dp\tw@\relax
+ {\color{VerbatimBorderColor}% frame color
+ \hrule\@height\sphinxverbatimborder % width computed by TeX
+ \setbox\tw@\hb@xt@\wd\z@
+ {% the vrule height will be auto computed later by TeX
+ \vrule\@width\sphinxverbatimborder
+ \hss
+ \vrule\@width\sphinxverbatimborder
+ }%
+ \ht\tw@\dimexpr\ht\z@-\sphinxverbatimborder\relax
+ \dp\tw@\dimexpr\dp\z@-\sphinxverbatimborder\relax
+ \box\tw@
+ \hrule\@height\sphinxverbatimborder
+ }% color pop here
+ % now the contents
+ \kern-\dimexpr\ht\tw@+\dp\tw@\relax
+ \box\z@
+ % Former code had a \hrule here so we need to suppress interline glue
+ % to keep exact same output now that it is a \hbox above
+ \nointerlineskip
+ % TODO: add some \lineskip glue here, this is all in a \vbox so can't split
+ #2% continuation hint attached below frame
+ }% end of \vbox
}%
\def\spx@fcolorbox@put@c#1{% hide width from framed.sty measuring
- \moveright\dimexpr\fboxrule+.5\wd\spx@verb@tempboxa\hb@xt@\z@{\hss#1\hss}%
+ \moveright.5\wd\tw@\hb@xt@\z@{\hss#1\hss}%
}%
\def\spx@fcolorbox@put@r#1{% right align with contents, width hidden
- \moveright\dimexpr\fboxrule+\wd\spx@verb@tempboxa-\fboxsep\hb@xt@\z@{\hss#1}%
+ \moveright\dimexpr\wd\tw@-\sphinxverbatimsep-\sphinxverbatimborder\hb@xt@\z@{\hss#1}%
}%
\def\spx@fcolorbox@put@l#1{% left align with contents, width hidden
- \moveright\dimexpr\fboxrule+\fboxsep\hb@xt@\z@{#1\hss}%
+ \moveright\dimexpr\sphinxverbatimborder+\sphinxverbatimsep\hb@xt@\z@{#1\hss}%
}%
%
\def\sphinxVerbatim@Continued
@@ -204,15 +206,14 @@
\newcommand*\literalblockcontinuedname{continued from previous page}%
\newcommand*\literalblockcontinuesname{continues on next page}%
%
-\def\spx@verbatimfcolorbox{\spx@fcolorbox{VerbatimBorderColor}{VerbatimColor}}%
\def\sphinxVerbatim@FrameCommand
- {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@After}%
+ {\spx@verb@FrameCommand\sphinxVerbatim@Before\sphinxVerbatim@After}%
\def\sphinxVerbatim@FirstFrameCommand
- {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@Continues}%
+ {\spx@verb@FrameCommand\sphinxVerbatim@Before\sphinxVerbatim@Continues}%
\def\sphinxVerbatim@MidFrameCommand
- {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@Continues}%
+ {\spx@verb@FrameCommand\sphinxVerbatim@Continued\sphinxVerbatim@Continues}%
\def\sphinxVerbatim@LastFrameCommand
- {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@After}%
+ {\spx@verb@FrameCommand\sphinxVerbatim@Continued\sphinxVerbatim@After}%
% For linebreaks inside Verbatim environment from package fancyvrb.
\newbox\sphinxcontinuationbox
@@ -310,7 +311,11 @@
\sphinxVerbatimFormatLine{#1}%
\fi
}%
+\let\spx@original@set@color\set@color
\newcommand\sphinxVerbatimHighlightLine[1]{%
+% This is morally a \colorbox (with a \fboxsep which would be 0pt)
+% but some issues of potential colour disappearance at pagebreaks
+% require workaround such as the one done here.
\leavevmode
% MEMO: usage of original \colorbox would insert a \set@color here
% and this then places a "color pop" at the end of the \box\z@.
@@ -675,8 +680,6 @@
\fi
\global\let\sphinxLiteralBlockLabel\empty
\global\let\sphinxVerbatimTitle\empty
- \fboxsep\sphinxverbatimsep \fboxrule\sphinxverbatimborder
- \ifspx@opt@verbatimwithframe\else\fboxrule\z@\fi
\let\FrameCommand \sphinxVerbatim@FrameCommand
\let\FirstFrameCommand\sphinxVerbatim@FirstFrameCommand
\let\MidFrameCommand \sphinxVerbatim@MidFrameCommand
@@ -756,8 +759,11 @@
\dp\sphinxVerbatim@ContentsBox+
\ht\sphinxVerbatim@TitleBox+
\dp\sphinxVerbatim@TitleBox+
- 2\fboxsep+2\fboxrule+
+ 2\sphinxverbatimsep+\ifspx@opt@verbatimwithframe 2\sphinxverbatimborder+\fi
% try to account for external frame parameters
+ % MEMO: this is because the sphinxheavybox (for warning admonitions)
+ % environment sets \FrameSep and \FrameRule
+ % TODO: fix this bad implicit dependency
\FrameSep+\FrameRule+
% Usage here of 2 baseline distances is empirical.
% In border case where code-block fits barely in remaining space,
diff --git a/sphinx/texinputs/sphinxpackageboxes.sty b/sphinx/texinputs/sphinxpackageboxes.sty
new file mode 100644
index 000000000..f07b9b64c
--- /dev/null
+++ b/sphinx/texinputs/sphinxpackageboxes.sty
@@ -0,0 +1,116 @@
+%% COLORED BOXES
+%
+% change this info string if making any custom modification
+\ProvidesPackage{sphinxpackageboxes}[2022/07/04 v5.1.0 advanced colored boxes]
+
+% Currently, this file only provides a replacement to the \spx@verb@fcolorbox
+% of sphinxlatexliterals.sty which will draw boxes with a frame having
+% rounded corners, and a background color.
+%
+% It needs \sphinxverbatimsep, \sphinxverbatimborder and a new parameter
+% \sphinxverbatimradius
+%
+% Executes \RequirePackage for:
+%
+% - pict2e. Ideally we would need a recent version of this package which
+% allows dimensional arguments to its \moveto, \lineto, etc...
+% but we add ourselves some wrapper to facilitate the usage.
+
+
+% MEMO: we have also successfully tested usage of tcolorbox's \tcbox but
+% decided to use pict2e.sty for the following reasons:
+% 1- an order of magnitude faster for what we want to do,
+% 2- orders of magnitude smaller dependency (tcolorbox uses the pgf TeX
+% framework)
+% 3- possibility to accomplish already quite fancy boxes with pict2e
+% (and the additional coding as contributed here).
+
+% In this first installment, the caption and continuation hints of code-blocks
+% are done exactly as formerly; only difference is in the rounded corrners.
+% The space occupied is same, if nothing else is changed.
+
+\IfFileExists{pict2e.sty}
+ {\RequirePackage{pict2e}}
+ {\PackageWarningNoLine{sphinx}{%
+ The package pict2e is required for rounded boxes.\MessageBreak
+ It does not seem to be available on your system.\MessageBreak
+ The verbatimradius setting will thus be ignored}%
+ \AtEndDocument{\PackageWarningNoLine{sphinx}{%
+ I issued a warning which may have gotten lost in the\MessageBreak
+ gigantic console output: pict2e.sty was not found,\MessageBreak
+ and verbatimradius has been ignored}}\endinput}
+
+% First we define some wrapper to be able to use arguments being (only)
+% dimensions or dimensional expressions. The \unitlength will always be 1pt.
+\def\spx@moveto(#1,#2)%
+ {\moveto(\strip@pt\dimexpr#1,\strip@pt\dimexpr#2)}
+\def\spx@lineto(#1,#2)%
+ {\lineto(\strip@pt\dimexpr#1,\strip@pt\dimexpr#2)}
+% attention we use here [2] always; and there are two more mandatory
+% arguments, angles, we don't need to worry about them here.
+\def\spx@circlearc#1#2#3{\circlearc[2]%
+ {\strip@pt\dimexpr#1}{\strip@pt\dimexpr#2}{\strip@pt\dimexpr#3}%
+}
+
+% TODO: add top right bottom left padding possibilities.
+\long\def\spx@verb@fcolorbox #1#2#3{%
+ % Prepare a box with the contents and reserved space for framing.
+ \setbox\tw@\hbox{\kern\dimexpr\sphinxverbatimborder+\sphinxverbatimsep\relax
+ {#3}\kern\dimexpr\sphinxverbatimborder+\sphinxverbatimsep\relax}%
+ \ht\tw@ \dimexpr\ht\tw@+\sphinxverbatimsep+\sphinxverbatimborder\relax
+ \dp\tw@ \dimexpr\dp\tw@+\sphinxverbatimsep+\sphinxverbatimborder\relax
+ \vbox{%
+% Prepare a macro for path to be inserted in a picture environment for stroke
+% and fill; the path will be redefined for each of fill or stroke. This macro
+% does nothing yet.
+\def\spx@dopath{%
+ \spx@moveto(\sphinxverbatimradius,\z@)% \z@ not 0 as our \spx@moveto is quite dumb
+ \spx@lineto(\wd\tw@-\sphinxverbatimborder-\sphinxverbatimradius,\z@)%
+ \spx@circlearc{\wd\tw@-\sphinxverbatimborder-\sphinxverbatimradius}%
+ {\sphinxverbatimradius}%
+ {\sphinxverbatimradius}{-90}{0}%
+ \spx@lineto(\wd\tw@-\sphinxverbatimborder,\ht\tw@+\dp\tw@-\sphinxverbatimborder-\sphinxverbatimradius)%
+ \spx@circlearc{\wd\tw@-\sphinxverbatimborder-\sphinxverbatimradius}
+ {\ht\tw@+\dp\tw@-\sphinxverbatimborder-\sphinxverbatimradius}%
+ {\sphinxverbatimradius}{0}{90}%
+ \spx@lineto(\sphinxverbatimradius,\ht\tw@+\dp\tw@-\sphinxverbatimborder)%
+ \spx@circlearc{\sphinxverbatimradius}%
+ {\ht\tw@+\dp\tw@-\sphinxverbatimborder-\sphinxverbatimradius}%
+ {\sphinxverbatimradius}{90}{180}%
+ \spx@lineto(\z@,\sphinxverbatimradius)%
+ \spx@circlearc{\sphinxverbatimradius}{\sphinxverbatimradius}{\sphinxverbatimradius}{180}{270}%
+}% end of definition of \spx@dopath
+%
+ #1% continuation hint attached above frame
+ % there will be a small "\lineskip" space here from TeX
+ % draw frame border _latest_ to avoid pdf viewer issue
+ % be careful not to cause "color push + contents + color pop"
+% MEMO: when pict2e doth a path stroke, the path is in the middle of the line
+% width, i.e. the line extends by half its width to the exterior of the filled
+% path. This explains some 0.5 things below.
+ \hbox{\setlength{\unitlength}{1pt}% attention to space token here
+% work around for "old" LaTeX (we could use the "picture" package, this
+% would add another dependency)
+ \begin{picture}%
+ (\strip@pt\wd\tw@,\strip@pt\dimexpr\ht\tw@+\dp\tw@)%
+ (\strip@pt\dimexpr-.5\sphinxverbatimborder,\strip@pt\dimexpr-.5\sphinxverbatimborder)%
+ \color{VerbatimColor}% color for background
+ \spx@dopath\fillpath
+ \color{VerbatimBorderColor}% color for border
+\ifspx@opt@verbatimwithframe % even with \sphinxverbatimborder set to 0pt, the
+ % stroke will produce a visible contour, so we
+ % must explicitly exclude doing it.
+ \linethickness{\sphinxverbatimborder}%
+ \spx@dopath\strokepath
+\fi
+ \end{picture}}%
+ % now the contents
+ \kern-\dimexpr\ht\tw@+\dp\tw@\relax
+ \copy\tw@ % attention that #2 will need \wd\tw@
+ \nointerlineskip
+ % TODO: add some \lineskip glue here, this is all in a \vbox so can't split
+ #2% continuation hint attached below frame
+ }% end of \vbox
+}%
+
+\endinput
diff --git a/sphinx/themes/basic/static/basic.css_t b/sphinx/themes/basic/static/basic.css_t
index 47f802dc4..2effcd963 100644
--- a/sphinx/themes/basic/static/basic.css_t
+++ b/sphinx/themes/basic/static/basic.css_t
@@ -340,7 +340,7 @@ p.sidebar-title {
{%- if docutils_version_info[:2] >= (0, 18) %}
nav.contents,
aside.topic,
-{% endif %}
+{%- endif %}
div.admonition, div.topic, blockquote {
clear: left;
}
@@ -350,7 +350,7 @@ div.admonition, div.topic, blockquote {
{%- if docutils_version_info[:2] >= (0, 18) %}
nav.contents,
aside.topic,
-{% endif %}
+{%- endif %}
div.topic {
border: 1px solid #ccc;
padding: 7px;
@@ -392,7 +392,7 @@ aside.sidebar > :last-child,
{%- if docutils_version_info[:2] >= (0, 18) %}
nav.contents > :last-child,
aside.topic > :last-child,
-{% endif %}
+{%- endif %}
div.topic > :last-child,
div.admonition > :last-child {
margin-bottom: 0;
@@ -403,7 +403,7 @@ aside.sidebar::after,
{%- if docutils_version_info[:2] >= (0, 18) %}
nav.contents::after,
aside.topic::after,
-{% endif %}
+{%- endif %}
div.topic::after,
div.admonition::after,
blockquote::after {
@@ -629,7 +629,7 @@ ul.simple p {
margin-bottom: 0;
}
-/* Docutils 0.17 and older (footnotes & citations) */
+{%- if docutils_version_info[:2] < (0, 18) %}
dl.footnote > dt,
dl.citation > dt {
float: left;
@@ -646,8 +646,7 @@ dl.citation > dd:after {
content: "";
clear: both;
}
-
-/* Docutils 0.18+ (footnotes & citations) */
+{%- elif docutils_version_info[:2] >= (0, 18) %}
aside.footnote > span,
div.citation > span {
float: left;
@@ -671,8 +670,7 @@ div.citation > p:last-of-type:after {
content: "";
clear: both;
}
-
-/* Footnotes & citations ends */
+{%- endif %}
dl.field-list {
display: grid;
diff --git a/sphinx/util/docutils.py b/sphinx/util/docutils.py
index b2944ec28..88bdaf943 100644
--- a/sphinx/util/docutils.py
+++ b/sphinx/util/docutils.py
@@ -18,6 +18,7 @@ from docutils.parsers.rst import Directive, directives, roles
from docutils.parsers.rst.states import Inliner
from docutils.statemachine import State, StateMachine, StringList
from docutils.utils import Reporter, unescape
+from docutils.writers._html_base import HTMLTranslator # NoQA
from sphinx.deprecation import RemovedInSphinx70Warning, deprecated_alias
from sphinx.errors import SphinxError
@@ -183,9 +184,45 @@ def using_user_docutils_conf(confdir: Optional[str]) -> Generator[None, None, No
@contextmanager
+def du19_footnotes() -> Generator[None, None, None]:
+ def visit_footnote(self, node):
+ label_style = self.settings.footnote_references
+ if not isinstance(node.previous_sibling(), type(node)):
+ self.body.append(f'<aside class="footnote-list {label_style}">\n')
+ self.body.append(self.starttag(node, 'aside',
+ classes=[node.tagname, label_style],
+ role="note"))
+
+ def depart_footnote(self, node):
+ self.body.append('</aside>\n')
+ if not isinstance(node.next_node(descend=False, siblings=True),
+ type(node)):
+ self.body.append('</aside>\n')
+
+ old_visit_footnote = HTMLTranslator.visit_footnote
+ old_depart_footnote = HTMLTranslator.depart_footnote
+
+ # Only apply on Docutils 0.18 or 0.18.1, as 0.17 and earlier used a <dl> based
+ # approach, and 0.19 and later use the fixed approach by default.
+ if docutils.__version_info__[:2] == (0, 18):
+ HTMLTranslator.visit_footnote = visit_footnote # type: ignore[assignment]
+ HTMLTranslator.depart_footnote = depart_footnote # type: ignore[assignment]
+
+ try:
+ yield
+ finally:
+ if docutils.__version_info__[:2] == (0, 18):
+ HTMLTranslator.visit_footnote = old_visit_footnote # type: ignore[assignment]
+ HTMLTranslator.depart_footnote = old_depart_footnote # type: ignore[assignment]
+
+
+@contextmanager
def patch_docutils(confdir: Optional[str] = None) -> Generator[None, None, None]:
"""Patch to docutils temporarily."""
- with patched_get_language(), patched_rst_get_language(), using_user_docutils_conf(confdir):
+ with patched_get_language(), \
+ patched_rst_get_language(), \
+ using_user_docutils_conf(confdir), \
+ du19_footnotes():
yield
diff --git a/sphinx/writers/latex.py b/sphinx/writers/latex.py
index ffadb67aa..447943c86 100644
--- a/sphinx/writers/latex.py
+++ b/sphinx/writers/latex.py
@@ -687,10 +687,10 @@ class LaTeXTranslator(SphinxTranslator):
self.body.append('}')
def visit_desc_signature(self, node: Element) -> None:
+ hyper = ''
if node.parent['objtype'] != 'describe' and node['ids']:
- hyper = self.hypertarget(node['ids'][0])
- else:
- hyper = ''
+ for id in node['ids']:
+ hyper += self.hypertarget(id)
self.body.append(hyper)
if not self.in_desc_signature:
self.in_desc_signature = True
diff --git a/tests/test_events.py b/tests/test_events.py
index f36c86a87..8f01a673a 100644
--- a/tests/test_events.py
+++ b/tests/test_events.py
@@ -19,11 +19,16 @@ def test_event_priority():
assert result == [3, 1, 2, 5, 4]
+class FakeApp:
+ def __init__(self, pdb: bool = False):
+ self.pdb = pdb
+
+
def test_event_allowed_exceptions():
def raise_error(app):
raise RuntimeError
- events = EventManager(object()) # pass an dummy object as an app
+ events = EventManager(FakeApp()) # pass an dummy object as an app
events.connect('builder-inited', raise_error, priority=500)
# all errors are converted to ExtensionError
@@ -33,3 +38,19 @@ def test_event_allowed_exceptions():
# Allow RuntimeError (pass-through)
with pytest.raises(RuntimeError):
events.emit('builder-inited', allowed_exceptions=(RuntimeError,))
+
+
+def test_event_pdb():
+ def raise_error(app):
+ raise RuntimeError
+
+ events = EventManager(FakeApp(pdb=True)) # pass an dummy object as an app
+ events.connect('builder-inited', raise_error, priority=500)
+
+ # errors aren't converted
+ with pytest.raises(RuntimeError):
+ events.emit('builder-inited')
+
+ # Allow RuntimeError (pass-through)
+ with pytest.raises(RuntimeError):
+ events.emit('builder-inited', allowed_exceptions=(RuntimeError,))
diff --git a/tox.ini b/tox.ini
index 8282017e4..664215955 100644
--- a/tox.ini
+++ b/tox.ini
@@ -37,11 +37,6 @@ commands =
python -m pip install "git+https://repo.or.cz/docutils.git#subdirectory=docutils"
{[testenv]commands}
-[testenv:du19pre]
-commands =
- python -m pip install --pre "docutils==0.19.*"
- {[testenv]commands}
-
[testenv:flake8]
basepython = python3
description =
@@ -80,7 +75,7 @@ description =
extras =
docs
commands =
- python -X dev -X warn_default_encoding -m sphinx -M html ./doc ./build/sphinx -W
+ python -X dev -X warn_default_encoding -m sphinx -M html ./doc ./build/sphinx -W --keep-going
[testenv:docslint]
basepython = python3