From cfdfa0194d7358564adced1ba1126dd50978d687 Mon Sep 17 00:00:00 2001 From: sphinx-auto-update Date: Fri, 11 Oct 2024 01:00:27 +0000 Subject: [PATCH] Update translations by GHA https://github.com/sphinx-doc/sphinx-doc-translations/actions/runs/11284313503 --- locale/ar/LC_MESSAGES/changes/index.po | 21 +- locale/ar/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/ar/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/ca_ES/LC_MESSAGES/changes/index.po | 21 +- locale/ca_ES/LC_MESSAGES/extdev/builderapi.po | 52 ++- .../ca_ES/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/de/LC_MESSAGES/changes/index.po | 21 +- locale/de/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/de/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/es/LC_MESSAGES/changes/index.po | 21 +- locale/es/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/es/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/fr/LC_MESSAGES/changes/index.po | 21 +- locale/fr/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/fr/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 35 +- locale/it_IT/LC_MESSAGES/changes/index.po | 21 +- locale/it_IT/LC_MESSAGES/extdev/builderapi.po | 52 ++- .../it_IT/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/ja/LC_MESSAGES/changes/index.po | 21 +- locale/ja/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/ja/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 33 +- locale/ko/LC_MESSAGES/changes/index.po | 21 +- locale/ko/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/ko/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/pl_PL/LC_MESSAGES/changes/index.po | 21 +- locale/pl_PL/LC_MESSAGES/extdev/builderapi.po | 52 ++- .../pl_PL/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/pot/extdev/builderapi.pot | 46 +- locale/pot/usage/configuration.pot | 408 ++++++++--------- .../pot/usage/extensions/autosectionlabel.pot | 24 +- locale/pt_BR/LC_MESSAGES/changes/index.po | 23 +- locale/pt_BR/LC_MESSAGES/extdev/builderapi.po | 60 ++- .../pt_BR/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 35 +- locale/ru/LC_MESSAGES/changes/index.po | 21 +- locale/ru/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/ru/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/sr/LC_MESSAGES/changes/index.po | 21 +- locale/sr/LC_MESSAGES/extdev/builderapi.po | 52 ++- locale/sr/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 26 +- locale/zh_CN/LC_MESSAGES/changes/index.po | 21 +- locale/zh_CN/LC_MESSAGES/extdev/builderapi.po | 52 ++- .../zh_CN/LC_MESSAGES/usage/configuration.po | 411 +++++++++--------- .../usage/extensions/autosectionlabel.po | 31 +- sphinx | 2 +- 56 files changed, 3861 insertions(+), 3289 deletions(-) diff --git a/locale/ar/LC_MESSAGES/changes/index.po b/locale/ar/LC_MESSAGES/changes/index.po index 0bf846e28a..2c0122686a 100644 --- a/locale/ar/LC_MESSAGES/changes/index.po +++ b/locale/ar/LC_MESSAGES/changes/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n" "MIME-Version: 1.0\n" @@ -22,7 +22,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -306,11 +306,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/ar/LC_MESSAGES/extdev/builderapi.po b/locale/ar/LC_MESSAGES/extdev/builderapi.po index 287665177a..6c23f11eb5 100644 --- a/locale/ar/LC_MESSAGES/extdev/builderapi.po +++ b/locale/ar/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/ar/LC_MESSAGES/usage/configuration.po b/locale/ar/LC_MESSAGES/usage/configuration.po index 81c9fe81a9..1a97d294b7 100644 --- a/locale/ar/LC_MESSAGES/usage/configuration.po +++ b/locale/ar/LC_MESSAGES/usage/configuration.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: Abdullah ahmed , 2023\n" "Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n" @@ -461,17 +461,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -920,7 +920,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1206,20 +1206,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1822,7 +1822,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1884,7 +1884,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2162,7 +2162,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2170,7 +2170,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2930,29 +2930,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3114,8 +3114,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3128,7 +3128,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3137,7 +3137,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3150,7 +3150,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3170,7 +3170,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3319,22 +3319,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3343,13 +3348,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3360,20 +3365,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3381,25 +3386,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3407,13 +3412,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3421,14 +3426,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3436,13 +3441,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3450,14 +3455,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3467,7 +3472,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3477,124 +3482,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3603,74 +3608,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3678,7 +3683,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3686,46 +3691,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3733,144 +3738,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3878,26 +3883,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3905,7 +3910,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3913,79 +3918,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3994,7 +3999,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4003,7 +4008,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4011,81 +4016,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4095,32 +4100,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4130,26 +4135,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4157,36 +4162,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "أمثلة" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4194,23 +4199,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4218,21 +4223,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/ar/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/ar/LC_MESSAGES/usage/extensions/autosectionlabel.po index 04c14545b8..72fbec81a8 100644 --- a/locale/ar/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/ar/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/ca_ES/LC_MESSAGES/changes/index.po b/locale/ca_ES/LC_MESSAGES/changes/index.po index 9c570617ee..3c1007fabd 100644 --- a/locale/ca_ES/LC_MESSAGES/changes/index.po +++ b/locale/ca_ES/LC_MESSAGES/changes/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Language-Team: Catalan (Spain) (https://app.transifex.com/sphinx-doc/teams/15434/ca_ES/)\n" "MIME-Version: 1.0\n" @@ -22,7 +22,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -306,11 +306,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/ca_ES/LC_MESSAGES/extdev/builderapi.po b/locale/ca_ES/LC_MESSAGES/extdev/builderapi.po index b8e9dd79b1..305e795fde 100644 --- a/locale/ca_ES/LC_MESSAGES/extdev/builderapi.po +++ b/locale/ca_ES/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Catalan (Spain) (https://app.transifex.com/sphinx-doc/teams/15434/ca_ES/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/ca_ES/LC_MESSAGES/usage/configuration.po b/locale/ca_ES/LC_MESSAGES/usage/configuration.po index 07ea322643..df2f5d896f 100644 --- a/locale/ca_ES/LC_MESSAGES/usage/configuration.po +++ b/locale/ca_ES/LC_MESSAGES/usage/configuration.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Language-Team: Catalan (Spain) (https://app.transifex.com/sphinx-doc/teams/15434/ca_ES/)\n" "MIME-Version: 1.0\n" @@ -457,17 +457,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -916,7 +916,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1202,20 +1202,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1818,7 +1818,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1880,7 +1880,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2158,7 +2158,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2166,7 +2166,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2926,29 +2926,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3110,8 +3110,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3124,7 +3124,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3133,7 +3133,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3146,7 +3146,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3166,7 +3166,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3315,22 +3315,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3339,13 +3344,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3356,20 +3361,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3377,25 +3382,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3403,13 +3408,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3417,14 +3422,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3432,13 +3437,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3446,14 +3451,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3463,7 +3468,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3473,124 +3478,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3599,74 +3604,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3674,7 +3679,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3682,46 +3687,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3729,144 +3734,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3874,26 +3879,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3901,7 +3906,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3909,79 +3914,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3990,7 +3995,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -3999,7 +4004,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4007,81 +4012,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4091,32 +4096,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4126,26 +4131,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4153,36 +4158,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4190,23 +4195,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4214,21 +4219,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/ca_ES/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/ca_ES/LC_MESSAGES/usage/extensions/autosectionlabel.po index 925201231a..270421cf5e 100644 --- a/locale/ca_ES/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/ca_ES/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Catalan (Spain) (https://app.transifex.com/sphinx-doc/teams/15434/ca_ES/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/de/LC_MESSAGES/changes/index.po b/locale/de/LC_MESSAGES/changes/index.po index 9c73a5d989..ea69f7edfb 100644 --- a/locale/de/LC_MESSAGES/changes/index.po +++ b/locale/de/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: Georg Brandl , 2024\n" "Language-Team: German (https://app.transifex.com/sphinx-doc/teams/15434/de/)\n" @@ -26,7 +26,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -310,11 +310,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/de/LC_MESSAGES/extdev/builderapi.po b/locale/de/LC_MESSAGES/extdev/builderapi.po index 067125eacb..b934f6cce7 100644 --- a/locale/de/LC_MESSAGES/extdev/builderapi.po +++ b/locale/de/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: German (https://app.transifex.com/sphinx-doc/teams/15434/de/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/de/LC_MESSAGES/usage/configuration.po b/locale/de/LC_MESSAGES/usage/configuration.po index 6ef1bec536..13d93613e6 100644 --- a/locale/de/LC_MESSAGES/usage/configuration.po +++ b/locale/de/LC_MESSAGES/usage/configuration.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Language-Team: German (https://app.transifex.com/sphinx-doc/teams/15434/de/)\n" "MIME-Version: 1.0\n" @@ -457,17 +457,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -916,7 +916,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1202,20 +1202,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1818,7 +1818,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1880,7 +1880,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2158,7 +2158,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2166,7 +2166,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2926,29 +2926,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3110,8 +3110,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3124,7 +3124,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3133,7 +3133,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3146,7 +3146,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3166,7 +3166,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3315,22 +3315,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3339,13 +3344,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3356,20 +3361,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3377,25 +3382,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3403,13 +3408,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3417,14 +3422,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3432,13 +3437,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3446,14 +3451,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3463,7 +3468,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3473,124 +3478,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3599,74 +3604,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3674,7 +3679,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3682,46 +3687,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3729,144 +3734,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3874,26 +3879,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3901,7 +3906,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3909,79 +3914,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3990,7 +3995,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -3999,7 +4004,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4007,81 +4012,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4091,32 +4096,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4126,26 +4131,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4153,36 +4158,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4190,23 +4195,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4214,21 +4219,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/de/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/de/LC_MESSAGES/usage/extensions/autosectionlabel.po index 90fce35b01..e685b27d7b 100644 --- a/locale/de/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/de/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: German (https://app.transifex.com/sphinx-doc/teams/15434/de/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/es/LC_MESSAGES/changes/index.po b/locale/es/LC_MESSAGES/changes/index.po index 9bdbb66d2e..9311a9ee71 100644 --- a/locale/es/LC_MESSAGES/changes/index.po +++ b/locale/es/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: Takayuki SHIMIZUKAWA , 2024\n" "Language-Team: Spanish (https://app.transifex.com/sphinx-doc/teams/15434/es/)\n" @@ -26,7 +26,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -310,11 +310,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/es/LC_MESSAGES/extdev/builderapi.po b/locale/es/LC_MESSAGES/extdev/builderapi.po index d6278a88de..d557dd7ff1 100644 --- a/locale/es/LC_MESSAGES/extdev/builderapi.po +++ b/locale/es/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Spanish (https://app.transifex.com/sphinx-doc/teams/15434/es/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/es/LC_MESSAGES/usage/configuration.po b/locale/es/LC_MESSAGES/usage/configuration.po index 9f7f671150..ebc2b91b30 100644 --- a/locale/es/LC_MESSAGES/usage/configuration.po +++ b/locale/es/LC_MESSAGES/usage/configuration.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: Edward Villegas-Pulgarin , 2024\n" "Language-Team: Spanish (https://app.transifex.com/sphinx-doc/teams/15434/es/)\n" @@ -462,17 +462,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -921,7 +921,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1207,20 +1207,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1823,7 +1823,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1885,7 +1885,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2163,7 +2163,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2171,7 +2171,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2931,29 +2931,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3115,8 +3115,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3129,7 +3129,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3138,7 +3138,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3151,7 +3151,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3171,7 +3171,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3320,22 +3320,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3344,13 +3349,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3361,20 +3366,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3382,25 +3387,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3408,13 +3413,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3422,14 +3427,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3437,13 +3442,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3451,14 +3456,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3468,7 +3473,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3478,124 +3483,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3604,74 +3609,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3679,7 +3684,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3687,46 +3692,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3734,144 +3739,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3879,26 +3884,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3906,7 +3911,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3914,79 +3919,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3995,7 +4000,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4004,7 +4009,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4012,81 +4017,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4096,32 +4101,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4131,26 +4136,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4158,36 +4163,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "Ejemplos" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4195,23 +4200,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4219,21 +4224,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "Opciones de extensión" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/es/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/es/LC_MESSAGES/usage/extensions/autosectionlabel.po index d5cc961bc5..ba39d0aeec 100644 --- a/locale/es/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/es/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Spanish (https://app.transifex.com/sphinx-doc/teams/15434/es/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/fr/LC_MESSAGES/changes/index.po b/locale/fr/LC_MESSAGES/changes/index.po index b77e92b984..31815f6815 100644 --- a/locale/fr/LC_MESSAGES/changes/index.po +++ b/locale/fr/LC_MESSAGES/changes/index.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: LAURENT Raphaël , 2024\n" "Language-Team: French (https://app.transifex.com/sphinx-doc/teams/15434/fr/)\n" @@ -28,7 +28,7 @@ msgid "Changelog" msgstr "Historique des modifications" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -312,11 +312,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "En cours de test" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/fr/LC_MESSAGES/extdev/builderapi.po b/locale/fr/LC_MESSAGES/extdev/builderapi.po index b8fdd483d0..16a2f2daa6 100644 --- a/locale/fr/LC_MESSAGES/extdev/builderapi.po +++ b/locale/fr/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: French (https://app.transifex.com/sphinx-doc/teams/15434/fr/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/fr/LC_MESSAGES/usage/configuration.po b/locale/fr/LC_MESSAGES/usage/configuration.po index cceff93542..cb72cadf8d 100644 --- a/locale/fr/LC_MESSAGES/usage/configuration.po +++ b/locale/fr/LC_MESSAGES/usage/configuration.po @@ -15,7 +15,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: niconil , 2024\n" "Language-Team: French (https://app.transifex.com/sphinx-doc/teams/15434/fr/)\n" @@ -474,17 +474,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "Exemple:" @@ -935,7 +935,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1223,20 +1223,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1842,7 +1842,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1904,7 +1904,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2196,7 +2196,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2204,7 +2204,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2971,29 +2971,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3155,8 +3155,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3169,7 +3169,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3178,7 +3178,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3191,7 +3191,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3211,7 +3211,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3363,22 +3363,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3387,13 +3392,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3404,20 +3409,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3425,25 +3430,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3451,13 +3456,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3465,14 +3470,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3480,13 +3485,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3494,14 +3499,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3511,7 +3516,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3521,102 +3526,102 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "Options pour la sortie text" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "These options influence text output." -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "Determines which end-of-line character(s) are used in text output." -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" @@ -3626,22 +3631,22 @@ msgstr "" "first character is used for first-level headings, the second for second-" "level headings and so on." -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "Options for manual page output" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "These options influence manual page output." -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3650,74 +3655,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "Options pour la sortie Texinfo" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "These options influence Texinfo output." -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3725,7 +3730,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3733,46 +3738,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3780,144 +3785,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "A list of document names to append as an appendix to all manuals." -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "Keys that you may want to override include:" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "``'paragraphindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "``'exampleindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "``'preamble'``" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "Texinfo markup inserted near the beginning of the file." -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "``'copying'``" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "Options pour la sortie QtHelp" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "Options for the linkcheck builder" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3925,26 +3930,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3952,7 +3957,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3960,79 +3965,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -4041,7 +4046,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4050,7 +4055,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4058,81 +4063,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4142,32 +4147,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "Options for the C++ domain" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4177,26 +4182,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4204,36 +4209,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "Exemples" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4241,23 +4246,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4265,21 +4270,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "Now also removes ````." -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "Options d'extension" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/fr/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/fr/LC_MESSAGES/usage/extensions/autosectionlabel.po index 43dd962bcf..906e7d2e3d 100644 --- a/locale/fr/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/fr/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Last-Translator: Jérémie Tarot , 2022\n" "Language-Team: French (https://app.transifex.com/sphinx-doc/teams/15434/fr/)\n" @@ -24,19 +24,15 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" -":mod:`sphinx.ext.autosectionlabel` -- Autoriser les références automatiques " -"aux sections par leurs titres" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" -"Cette extension vous permet de référencer les sections par leurs titres. " -"Ceci affecte le rôle de référencement (:rst:role:`ref`)." #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 msgid "For example::" @@ -60,7 +56,15 @@ msgstr "" msgid "Configuration" msgstr "Configuration" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -74,24 +78,19 @@ msgstr "" "``index.rst``. Utile pour éviter une ambiguïté quand le même titre de " "section apparaît dans différents documents." -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -"Si défini, autosectionlabel choisit les sections à étiqueter par leur " -"profondeur. Par exemple, avec la valeur 1 pour " -"``autosectionlabel_maxdepth``, les étiquettes ne sont générées que pour les " -"sections de premier niveau, et les sections de niveaux inférieurs ne sont " -"pas étiquetés. La valeur par défaut est ``None`` (désactivé)." -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "Débogage" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/it_IT/LC_MESSAGES/changes/index.po b/locale/it_IT/LC_MESSAGES/changes/index.po index 98d45fcb5f..33242d9453 100644 --- a/locale/it_IT/LC_MESSAGES/changes/index.po +++ b/locale/it_IT/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: 32e7d1c22f8d835b0e2261bd3e410b47_b6d0d5a <3e3890d708fef81118761bb1d0a44692_389909>, 2024\n" "Language-Team: Italian (Italy) (https://app.transifex.com/sphinx-doc/teams/15434/it_IT/)\n" @@ -26,7 +26,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -310,11 +310,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/it_IT/LC_MESSAGES/extdev/builderapi.po b/locale/it_IT/LC_MESSAGES/extdev/builderapi.po index 819ffa0b06..430d248ffa 100644 --- a/locale/it_IT/LC_MESSAGES/extdev/builderapi.po +++ b/locale/it_IT/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Italian (Italy) (https://app.transifex.com/sphinx-doc/teams/15434/it_IT/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/it_IT/LC_MESSAGES/usage/configuration.po b/locale/it_IT/LC_MESSAGES/usage/configuration.po index fde5360067..4b591d03a5 100644 --- a/locale/it_IT/LC_MESSAGES/usage/configuration.po +++ b/locale/it_IT/LC_MESSAGES/usage/configuration.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Language-Team: Italian (Italy) (https://app.transifex.com/sphinx-doc/teams/15434/it_IT/)\n" "MIME-Version: 1.0\n" @@ -457,17 +457,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -916,7 +916,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1202,20 +1202,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1818,7 +1818,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1880,7 +1880,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2158,7 +2158,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2166,7 +2166,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2926,29 +2926,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3110,8 +3110,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3124,7 +3124,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3133,7 +3133,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3146,7 +3146,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3166,7 +3166,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3315,22 +3315,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3339,13 +3344,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3356,20 +3361,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3377,25 +3382,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3403,13 +3408,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3417,14 +3422,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3432,13 +3437,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3446,14 +3451,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3463,7 +3468,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3473,124 +3478,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3599,74 +3604,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3674,7 +3679,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3682,46 +3687,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3729,144 +3734,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3874,26 +3879,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3901,7 +3906,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3909,79 +3914,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3990,7 +3995,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -3999,7 +4004,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4007,81 +4012,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4091,32 +4096,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4126,26 +4131,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4153,36 +4158,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4190,23 +4195,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4214,21 +4219,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/it_IT/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/it_IT/LC_MESSAGES/usage/extensions/autosectionlabel.po index c4c9677b51..75c73172c3 100644 --- a/locale/it_IT/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/it_IT/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Italian (Italy) (https://app.transifex.com/sphinx-doc/teams/15434/it_IT/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/ja/LC_MESSAGES/changes/index.po b/locale/ja/LC_MESSAGES/changes/index.po index 8ff604b82f..87f157ee71 100644 --- a/locale/ja/LC_MESSAGES/changes/index.po +++ b/locale/ja/LC_MESSAGES/changes/index.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: Takayuki SHIMIZUKAWA , 2024\n" "Language-Team: Japanese (https://app.transifex.com/sphinx-doc/teams/15434/ja/)\n" @@ -28,7 +28,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -312,11 +312,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/ja/LC_MESSAGES/extdev/builderapi.po b/locale/ja/LC_MESSAGES/extdev/builderapi.po index 7ea3c00815..69aecbd03c 100644 --- a/locale/ja/LC_MESSAGES/extdev/builderapi.po +++ b/locale/ja/LC_MESSAGES/extdev/builderapi.po @@ -15,7 +15,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Last-Translator: Tetsuo Koyama , 2020\n" "Language-Team: Japanese (https://app.transifex.com/sphinx-doc/teams/15434/ja/)\n" @@ -148,11 +148,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -173,11 +178,6 @@ msgid "" msgstr "" "もしもビルダーがソースファイルに関連する、個別のファイルを出力しない場合には、ここでは文字列を返してください。その場合には、書かれるべきファイルのイテレータを返します。" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr ":meth:`write_doc` が実行される前に実行したい動作を記述する場所です。" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -195,7 +195,11 @@ msgid "" "builders." msgstr "*typ* はそれぞれのビルダーごとのリンクの修飾子として使うことができます。" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -207,10 +211,22 @@ msgid "" msgstr "必要なテンプレートをロードしたり、初期化を行うためのメソッドです。 デフォルトの実装では、何も行いません。" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." msgstr "" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" +msgstr ":meth:`write_doc` が実行される前に実行したい動作を記述する場所です。" + #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.copy_assets:1 msgid "Where assets (images, static files, etc) are copied before writing" @@ -237,28 +253,28 @@ msgstr "ビルドプロセスの終了です。" msgid "The default implementation does nothing." msgstr "デフォルトの実装では何も呼び出されません。" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr ":class:`.EventManager` オブジェクト。" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -267,7 +283,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/ja/LC_MESSAGES/usage/configuration.po b/locale/ja/LC_MESSAGES/usage/configuration.po index 80b3e2a90e..d5f04e28d0 100644 --- a/locale/ja/LC_MESSAGES/usage/configuration.po +++ b/locale/ja/LC_MESSAGES/usage/configuration.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: Naofumi SAKAGUCHI , 2024\n" "Language-Team: Japanese (https://app.transifex.com/sphinx-doc/teams/15434/ja/)\n" @@ -465,17 +465,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "例:" @@ -924,7 +924,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1212,20 +1212,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1830,7 +1830,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1892,7 +1892,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2173,7 +2173,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2181,7 +2181,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2943,29 +2943,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3127,8 +3127,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3141,7 +3141,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3150,7 +3150,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3163,7 +3163,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3183,7 +3183,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3332,22 +3332,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3356,13 +3361,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3373,20 +3378,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3394,25 +3399,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3420,13 +3425,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3434,14 +3439,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3449,13 +3454,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3463,14 +3468,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3480,7 +3485,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3490,102 +3495,102 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "``manual``" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "テキスト出力のオプション" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "これらのオプションは、テキスト出力に影響を与えます。" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "テキスト出力で、どの改行コードを使用するのかを決定します。" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" @@ -3593,22 +3598,22 @@ msgid "" msgstr "" "7文字の文字列で、セクションタイトルで指定する記号を設定します。それぞれ、1文字目が最初のヘッダ、2文字目が2段目のヘッダとして使用されます。" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "manページ出力のオプション" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "これらのオプションは、manページ出力に影響を与えます。" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3617,74 +3622,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "Texinfo出力のオプション" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "これらのオプションは、Texinfo出力に影響を与えます。" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3692,7 +3697,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3700,46 +3705,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3747,144 +3752,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "すべてのマニュアルのAppendixに追加されるドキュメント名のリストです。" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "オーバーライドできるキーには、次のようなものがあります:" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "``'paragraphindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "``'exampleindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "``'preamble'``" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "Texinfoはこのファイルの先頭付近に挿入されます。" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "``'copying'``" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "リンクチェックビルダーのオプション" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3892,26 +3897,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3919,7 +3924,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3927,79 +3932,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "*auth_info*" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -4008,7 +4013,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4017,7 +4022,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4025,81 +4030,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4109,32 +4114,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "C++ ドメインのオプション" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4144,26 +4149,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4171,36 +4176,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "サンプル" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4208,23 +4213,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4232,21 +4237,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "```` も削除対象にしました。" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "拡張オプション" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/ja/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/ja/LC_MESSAGES/usage/extensions/autosectionlabel.po index a07106c6fd..f6f770bfea 100644 --- a/locale/ja/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/ja/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Last-Translator: Tetsuo Koyama , 2020\n" "Language-Team: Japanese (https://app.transifex.com/sphinx-doc/teams/15434/ja/)\n" @@ -25,16 +25,15 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" -msgstr ":mod:`sphinx.ext.autosectionlabel` -- タイトルを使用してセクションの参照ができます" +msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" -"この拡張は、セクションへの参照をそのタイトルを用いて行えるようにするものです。これは参照のロール(:rst:role:`ref`)に作用します。" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 msgid "For example::" @@ -56,7 +55,15 @@ msgstr "" msgid "Configuration" msgstr "設定" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -68,23 +75,19 @@ msgstr "" "に表示される ``Introduction`` というセクションの ``index:Introduction`` " "です。異なる文書に同じセクション見出しが表示される場合に曖昧さを避けるのに役立ちます。" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -"設定されている場合、autosectionlabelはその深さでラベル付けするセクションを選択します。たとえば、1を " -"``autosectionlabel_maxdepth`` " -"に設定すると、ラベルはトップレベルのセクションに対してのみ生成され、それより深いセクションにはラベルが付けられません。デフォルトは ``None`` " -"(無効)です。" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/ko/LC_MESSAGES/changes/index.po b/locale/ko/LC_MESSAGES/changes/index.po index 0aad653ad6..49f8dfb4c2 100644 --- a/locale/ko/LC_MESSAGES/changes/index.po +++ b/locale/ko/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: YT H , 2024\n" "Language-Team: Korean (https://app.transifex.com/sphinx-doc/teams/15434/ko/)\n" @@ -26,7 +26,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -310,11 +310,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/ko/LC_MESSAGES/extdev/builderapi.po b/locale/ko/LC_MESSAGES/extdev/builderapi.po index 29d3e3164a..ee1bfafe25 100644 --- a/locale/ko/LC_MESSAGES/extdev/builderapi.po +++ b/locale/ko/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Korean (https://app.transifex.com/sphinx-doc/teams/15434/ko/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/ko/LC_MESSAGES/usage/configuration.po b/locale/ko/LC_MESSAGES/usage/configuration.po index 2cccb79b0b..3559ffa3f5 100644 --- a/locale/ko/LC_MESSAGES/usage/configuration.po +++ b/locale/ko/LC_MESSAGES/usage/configuration.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: YT H , 2024\n" "Language-Team: Korean (https://app.transifex.com/sphinx-doc/teams/15434/ko/)\n" @@ -462,17 +462,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -921,7 +921,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1207,20 +1207,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1823,7 +1823,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1885,7 +1885,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2163,7 +2163,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2171,7 +2171,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2931,29 +2931,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3115,8 +3115,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3129,7 +3129,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3138,7 +3138,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3151,7 +3151,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3171,7 +3171,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3320,22 +3320,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3344,13 +3349,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3361,20 +3366,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3382,25 +3387,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3408,13 +3413,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3422,14 +3427,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3437,13 +3442,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3451,14 +3456,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3468,7 +3473,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3478,124 +3483,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3604,74 +3609,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3679,7 +3684,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3687,46 +3692,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3734,144 +3739,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "설정할 수 있는 변수들은 다음과 같습니다:" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3879,26 +3884,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3906,7 +3911,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3914,79 +3919,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3995,7 +4000,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4004,7 +4009,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4012,81 +4017,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4096,32 +4101,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4131,26 +4136,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4158,36 +4163,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "예제" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4195,23 +4200,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4219,21 +4224,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "확장 기능 옵션" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/ko/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/ko/LC_MESSAGES/usage/extensions/autosectionlabel.po index 34b987635d..7870b7a02b 100644 --- a/locale/ko/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/ko/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Korean (https://app.transifex.com/sphinx-doc/teams/15434/ko/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/pl_PL/LC_MESSAGES/changes/index.po b/locale/pl_PL/LC_MESSAGES/changes/index.po index 7a8bb220bb..eba918b142 100644 --- a/locale/pl_PL/LC_MESSAGES/changes/index.po +++ b/locale/pl_PL/LC_MESSAGES/changes/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Language-Team: Polish (Poland) (https://app.transifex.com/sphinx-doc/teams/15434/pl_PL/)\n" "MIME-Version: 1.0\n" @@ -22,7 +22,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -306,11 +306,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/pl_PL/LC_MESSAGES/extdev/builderapi.po b/locale/pl_PL/LC_MESSAGES/extdev/builderapi.po index a6fe79db6a..23cedded4b 100644 --- a/locale/pl_PL/LC_MESSAGES/extdev/builderapi.po +++ b/locale/pl_PL/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Polish (Poland) (https://app.transifex.com/sphinx-doc/teams/15434/pl_PL/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/pl_PL/LC_MESSAGES/usage/configuration.po b/locale/pl_PL/LC_MESSAGES/usage/configuration.po index 0211fd49d0..95773c3c9a 100644 --- a/locale/pl_PL/LC_MESSAGES/usage/configuration.po +++ b/locale/pl_PL/LC_MESSAGES/usage/configuration.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: Maciej Olko , 2023\n" "Language-Team: Polish (Poland) (https://app.transifex.com/sphinx-doc/teams/15434/pl_PL/)\n" @@ -461,17 +461,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -920,7 +920,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1206,20 +1206,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1822,7 +1822,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1884,7 +1884,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2162,7 +2162,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2170,7 +2170,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2930,29 +2930,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3114,8 +3114,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3128,7 +3128,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3137,7 +3137,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3150,7 +3150,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3170,7 +3170,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3319,22 +3319,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3343,13 +3348,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3360,20 +3365,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3381,25 +3386,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3407,13 +3412,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3421,14 +3426,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3436,13 +3441,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3450,14 +3455,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3467,7 +3472,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3477,124 +3482,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3603,74 +3608,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3678,7 +3683,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3686,46 +3691,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3733,144 +3738,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3878,26 +3883,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3905,7 +3910,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3913,79 +3918,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3994,7 +3999,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4003,7 +4008,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4011,81 +4016,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4095,32 +4100,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4130,26 +4135,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4157,36 +4162,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "Przykłady" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4194,23 +4199,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4218,21 +4223,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/pl_PL/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/pl_PL/LC_MESSAGES/usage/extensions/autosectionlabel.po index a79e88afcc..9b1656b947 100644 --- a/locale/pl_PL/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/pl_PL/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Polish (Poland) (https://app.transifex.com/sphinx-doc/teams/15434/pl_PL/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/pot/extdev/builderapi.pot b/locale/pot/extdev/builderapi.pot index 0d307d7d61..9bf04a99ca 100644 --- a/locale/pot/extdev/builderapi.pot +++ b/locale/pot/extdev/builderapi.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -116,11 +116,15 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -132,10 +136,6 @@ msgstr "" msgid "If the builder does not output individual files corresponding to source files, return a string here. If it does, return an iterable of those files that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." msgstr "" @@ -148,7 +148,11 @@ msgstr "" msgid "*typ* can be used to qualify the link characteristic for individual builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -156,8 +160,16 @@ msgstr "" msgid "Load necessary templates and perform initialization. The default implementation does nothing." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.write_documents:3 +msgid "This method can be overridden if a builder does not create output files for each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.py:docstring of sphinx.builders.Builder.copy_assets:1 @@ -180,30 +192,30 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "By default, the :mod:`linkcode ` extension will only inject references for an ``html`` builder. The ``supported_linkcode`` attribute can be defined in a non-HTML builder to support managing references generated by linkcode. The expected value for this attribute is an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "For example, if a builder was named ``custom-builder``, the following can be used:" msgstr "" diff --git a/locale/pot/usage/configuration.pot b/locale/pot/usage/configuration.pot index d00ff67055..95ced76f66 100644 --- a/locale/pot/usage/configuration.pot +++ b/locale/pot/usage/configuration.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -336,17 +336,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -739,7 +739,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -939,18 +939,18 @@ msgid "A boolean that decides whether parentheses are appended to function and m msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "If a signature's length in characters exceeds the number set, each parameter within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "When :code-py:`None`, there is no maximum length and the entire signature will be displayed on a single logical line." msgstr "" @@ -1437,7 +1437,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "A dictionary of options that influence the look and feel of the selected theme. These are theme-specific. The options understood by the :ref:`builtin themes ` are described :ref:`here `." msgstr "" @@ -1480,7 +1480,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -1665,13 +1665,13 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "If True, generate domain-specific indices in addition to the general index. For e.g. the Python domain, this is the global module index." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "This value can be a Boolean or a list of index names that should be generated. To find out the index name for a specific index, look at the HTML file name. For example, the Python module index has the name ``'py-modindex'``." msgstr "" @@ -2228,29 +2228,29 @@ msgid "Control how to display URL addresses. This is very useful for readers tha msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -2379,8 +2379,8 @@ msgid "This value determines how to group the document tree into LaTeX source fi msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -2389,7 +2389,7 @@ msgid "String that specifies the :term:`document name` of the LaTeX file's maste msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -2398,7 +2398,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -2407,7 +2407,7 @@ msgid "LaTeX document title. Can be empty to use the title of the *startdoc* doc msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -2424,7 +2424,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -2525,653 +2525,657 @@ msgid "With the :code-py:`'colorrows'` style, the :code-tex:`\\\\rowcolors` LaTe msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 -msgid "Each table can override the global style via ``:class:`` option, or ``.. rst-class::`` for no-directive tables (cf. :ref:`table-directives`). Currently recognised classes are ``booktabs``, ``borderless``, ``standard``, ``colorrows``, ``nocolorrows``. The latter two can be combined with any of the first three. The ``standard`` class produces tables with both horizontal and vertical lines (as has been the default so far with Sphinx)." +msgid "To customise the styles for a table, use the ``:class:`` option if the table is defined using a directive, or otherwise insert a :ref:`rst-class ` directive before the table (cf. :ref:`table-directives`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``, ``colorrows``, ``nocolorrows``. The latter two can be combined with any of the first three. The ``standard`` class produces tables with both horizontal and vertical lines (as has been the default so far with Sphinx)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "A single-row multi-column merged cell will obey the row colour, if it is set. See also ``TableMergeColor{Header,Odd,Even}`` in the :ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "It is hard-coded in LaTeX that a single cell will obey the row colour even if there is a column colour set via :code-tex:`\\\\columncolor` from a column specification (see :rst:dir:`tabularcolumns`). Sphinx provides :code-tex:`\\\\sphinxnorowcolor` which can be used in a table column specification like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "It means that in this column, the row colours will be slightly tinted by red; refer to xcolor_ documentation for more on the syntax of its :code-tex:`\\\\blendcolors` command (a :code-tex:`\\\\blendcolors` in place of :code-tex:`\\\\sphinxcolorblend` would modify colours of the cell *contents*, not of the cell *background colour panel*...). You can find an example of usage in the :ref:`dev-deprecated-apis` section of this document in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "If you want to use a special colour for the *contents* of the cells of a given column use ``>{\\noindent\\color{}}``, possibly in addition to the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "Multi-row merged cells, whether single column or multi-column currently ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "It is possible for a simple cell to set a custom colour via the :dudir:`raw` directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in the cell contents. This currently is without effect in a merged cell, whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "In a document not using ``'booktabs'`` globally, it is possible to style an individual table via the ``booktabs`` class, but it will be necessary to add ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "On the other hand one can use ``colorrows`` class for individual tables with no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "Use Xindy_ to prepare the index of general terms. By default, the LaTeX builder uses :program:`makeindex` for preparing the index of general terms . Using Xindy_ means that words with UTF-8 characters will be ordered correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` (Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing invalid bytes for the UTF-8 encoding if any indexed term starts with a non-ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-py:`True` is recommended for non-English documents as soon as some indexed terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "Sphinx adds some dedicated support to the :program:`xindy` base distribution for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both :code-py:`'pdflatex'` and Unicode engines, Cyrillic documents handle the indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid ":ref:`See the full documentation for latex_elements `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of real document classes that will be used as the base for the two Sphinx classes. Default is to use :code-py:`'article'` for :code-py:`'howto'` and :code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "A list of file names, relative to the :term:`configuration directory`, to copy to the build directory when building LaTeX output. This is useful to copy files that Sphinx doesn't copy automatically, or to overwrite Sphinx LaTeX support files with custom versions. Image files that are referenced in source files (e.g. via ``.. image::``) are copied automatically and should not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "Filenames with the ``.tex`` extension will be automatically handed over to the PDF build process triggered by :option:`sphinx-build -M latexpdf ` or by :program:`make latexpdf`. If the file was added only to be :code-tex:`\\\\input{}` from a modified preamble, you must add a further suffix such as ``.txt`` to the filename and adjust the :code-tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "The \"theme\" that the LaTeX output should use. It is a collection of settings for LaTeX output (e.g. document class, top level sectioning unit and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "A LaTeX theme for writing a manual. It imports the ``report`` document class (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "A LaTeX theme for writing an article. It imports the ``article`` document class (Japanese documents use ``jreport``). :confval:`latex_appendices` is only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "A dictionary of options that influence the look and feel of the selected theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "A list of paths that contain custom LaTeX themes as subdirectories. Relative paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "A string of 7 characters that should be used for underlining sections. The first character is used for first-level headings, the second for second-level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "This value determines how to group the document tree into manual pages. It must be a list of tuples ``(startdocname, name, description, authors, section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "String that specifies the :term:`document name` of the manual page's master document. All documents referenced by the *startdoc* document in ToC trees will be included in the manual page. (If you want to use the default master document for your manual pages build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "Name of the manual page. This should be a short string without spaces or special characters. It is used to determine the file name as well as the name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "Description of the manual page. This is used in the NAME section. Can be an empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "A list of strings with authors, or a single string. Can be an empty string or list if you do not want to automatically generate an AUTHORS section in the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "The manual page section. Used for the output file name as well as in the manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "This value determines how to group the document tree into Texinfo source files. It must be a list of tuples ``(startdocname, targetname, title, author, dir_entry, description, category, toctree_only)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "String that specifies the :term:`document name` of the Texinfo file's master document. All documents referenced by the *startdoc* document in ToC trees will be included in the Texinfo file. (If you want to use the default master document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "Texinfo document title. Can be empty to use the title of the *startdoc* document. Inserted as Texinfo markup, so special characters like ``@`` and ``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "Specifies the section which this entry will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* document itself is not included in the output, only the documents referenced by it via ToC trees. With this option, you can put extra stuff in the master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "Generate inline references in a document. Disabling inline references can make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "A dictionary that contains Texinfo snippets that override those that Sphinx usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "Number of spaces to indent the first line of each paragraph, default ``2``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "Number of spaces to indent the lines for examples or literal blocks, default ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "Texinfo markup inserted within the ``@copying`` block and displayed after the title. The default value consists of a simple title page identifying the project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "Keys that are set by other options and therefore should not be overridden are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, ``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "Control how to display URL addresses. The setting can have the following values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "These options influence qthelp output. This builder derives from the HTML builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "These options control which links the *linkcheck* builder checks, and which failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "A dictionary that maps a pattern of the source URI to a pattern of the canonical URI. The *linkcheck* builder treats the redirected link as \"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "The *linkcheck* builder will emit a warning when it finds redirected links that don't meet the rules above. It can be useful to detect unexpected redirects when using :option:`the fail-on-warnings mode `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "Check the validity of ``#anchor``\\ s in links. Since this requires downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "A list of regular expressions that match anchors that the *linkcheck* builder should skip when checking the validity of anchors in links. For example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "If you want to ignore anchors of a specific page or of pages that match a specific pattern (but still check occurrences of the same page(s) that don't have anchors), use :confval:`linkcheck_ignore` instead, for example as follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "A list or tuple of regular expressions matching URLs for which the *linkcheck* builder should not check the validity of anchors. This allows skipping anchor checks on a per-page basis while still checking the validity of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "A list of regular expressions that match documents in which the *linkcheck* builder should not check the validity of links. This can be used for permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "A list of regular expressions that match URIs that should not be checked when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "These options control how the *linkcheck* builder makes HTTP requests, including how it handles redirects and authentication, and the number of workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "Authentication information to use for that URI. The value can be anything that is understood by the ``requests`` library (see :ref:`requests authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "The *linkcheck* builder will use the first matching ``auth_info`` value it can find in the :confval:`!linkcheck_auth` list, so values earlier in the list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "When a webserver responds with an HTTP 401 (unauthorised) response, the current default behaviour of the *linkcheck* builder is to treat the link as \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "The default value for this option changed to :code-py:`False`, meaning HTTP 401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "The *linkcheck* builder may issue a large number of requests to the same site over a short period of time. This setting controls the builder behaviour when servers indicate that requests are rate-limited, by setting the maximum duration (in seconds) that the builder will wait for between each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "The *linkcheck* builder always respects a server's direction of when to retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for a minute before to retry and keeps doubling the wait time between attempts until it succeeds or exceeds the :confval:`!linkcheck_rate_limit_timeout` (in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "If :confval:`linkcheck_timeout` expires while waiting for a response from a hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by default. To report timeouts as ``broken`` instead, you can set :confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "The default value for this option changed to :code-py:`False`, meaning timeouts that occur while checking hyperlinks will be reported using the new 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "The number of times the *linkcheck* builder will attempt to check a URL before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "The duration, in seconds, that the *linkcheck* builder will wait for a response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "A sequence of strings that the parser should additionally accept as attributes. For example, this can be used when :code-c:`#define` has been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "This is a domain-specific setting, overriding :confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "A sequence of strings that the parser should additionally accept as attributes with one argument. That is, if ``my_align_as`` is in the list, then :code-c:`my_align_as(X)` is parsed as an attribute for all strings ``X`` that have balanced braces (:code-c:`()`, :code-c:`[]`, and :code-c:`{}`). For example, this can be used when :code-c:`#define` has been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "A sequence of strings that the parser should additionally accept as attributes. For example, this can be used when :code-cpp:`#define` has been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "A list of prefixes that will be ignored when sorting C++ objects in the global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "A sequence of strings that the parser should additionally accept as attributes with one argument. That is, if ``my_align_as`` is in the list, then :code-cpp:`my_align_as(X)` is parsed as an attribute for all strings ``X`` that have balanced braces (:code-cpp:`()`, :code-cpp:`[]`, and :code-cpp:`{}`). For example, this can be used when :code-cpp:`#define` has been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "A boolean that decides whether module names are prepended to all :term:`object` names (for object types where a \"module\" of some kind is defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "A list of prefixes that are ignored for sorting the Python module index (e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown under ``B``, not ``F``). This can be handy if you document a project that consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "When :code-py:`False`, :py:data:`~typing.Literal` types display as per standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short, :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "For the Python domain, the signature length depends on whether the type parameters or the list of arguments are being formatted. For the former, the signature length ignores the length of the arguments list; for the latter, the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "For instance, with :code-py:`python_maximum_signature_line_length = 20`, only the list of type parameters will be wrapped while the arguments list will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`) at the ends of lines and ```` markers for all code blocks showing interactive Python sessions (i.e. doctests). See the extension :mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "Extensions frequently have their own configuration options. Those for Sphinx's first-party extensions are documented in each :doc:`extension's page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/pot/usage/extensions/autosectionlabel.pot b/locale/pot/usage/extensions/autosectionlabel.pot index dfbba013a8..c4a4eabdd1 100644 --- a/locale/pot/usage/extensions/autosectionlabel.pot +++ b/locale/pot/usage/extensions/autosectionlabel.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -17,11 +17,11 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 -msgid ":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its title" +msgid ":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 -msgid "This extension allows you to refer sections its title. This affects to the reference role (:rst:role:`ref`)." +msgid "By default, cross-references to sections use labels (see :rst:role:`ref`). This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -36,18 +36,26 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "True to prefix each section label with the name of the document it is in, followed by a colon. For example, ``index:Introduction`` for a section called ``Introduction`` that appears in document ``index.rst``. Useful for avoiding ambiguity when the same section heading appears in different documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 -msgid "If set, autosectionlabel chooses the sections for labeling by its depth. For example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated only for top level sections, and deeper sections are not labeled. It defaults to ``None`` (disabled)." +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 +msgid "If set, autosectionlabel chooses the sections for labeling by its depth. For example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated only for top level sections, and deeper sections are not labeled. It defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "The ``WARNING: undefined label`` indicates that your reference in :rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with ``-vvv`` (see :option:`-v`) will print all section names and the labels that have been generated for them. This output can help finding the right reference label." msgstr "" diff --git a/locale/pt_BR/LC_MESSAGES/changes/index.po b/locale/pt_BR/LC_MESSAGES/changes/index.po index 8744e53682..d2f8194c40 100644 --- a/locale/pt_BR/LC_MESSAGES/changes/index.po +++ b/locale/pt_BR/LC_MESSAGES/changes/index.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Portuguese (Brazil) (https://app.transifex.com/sphinx-doc/teams/15434/pt_BR/)\n" @@ -27,8 +27,8 @@ msgid "Changelog" msgstr "Changelog" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" -msgstr "Versão 8.1.0 (em desenvolvimento)" +msgid "Release 8.1.0 (released Oct 10, 2024)" +msgstr "" #: ../../sphinx/CHANGES.rst:5 msgid "Dependencies" @@ -370,11 +370,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "Testes" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/pt_BR/LC_MESSAGES/extdev/builderapi.po b/locale/pt_BR/LC_MESSAGES/extdev/builderapi.po index 4cee231af9..5f9706ed6c 100644 --- a/locale/pt_BR/LC_MESSAGES/extdev/builderapi.po +++ b/locale/pt_BR/LC_MESSAGES/extdev/builderapi.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Portuguese (Brazil) (https://app.transifex.com/sphinx-doc/teams/15434/pt_BR/)\n" @@ -170,11 +170,16 @@ msgstr "" "Escreve a doctree em um arquivo, para ser usado como cache nas " "reconstruções." -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" -msgstr "Métodos substituíveis" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." +msgstr "Escreve arquivos de saída específicos do construtor." #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "Estes devem ser implementados em subclasses de construtor:" @@ -198,13 +203,6 @@ msgstr "" "fonte, retorna uma string aqui. Em caso afirmativo, retorna um iterável dos " "arquivos que precisam ser escritos." -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" -"Um lugar onde você pode adicionar lógica antes de :meth:`write_doc` ser " -"executado" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -224,7 +222,11 @@ msgstr "" "*typ* pode ser usado para qualificar a característica do link para " "construtores individuais." -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "Métodos substituíveis" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "Esses métodos podem ser substituídos nas subclasses do construtor:" @@ -238,9 +240,23 @@ msgstr "" "padrão não faz nada." #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." -msgstr "Escreve arquivos de saída específicos do construtor." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" +msgstr "" +"Um lugar onde você pode adicionar lógica antes de :meth:`write_doc` ser " +"executado" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.copy_assets:1 @@ -271,28 +287,28 @@ msgstr "Conclui o processo de construção." msgid "The default implementation does nothing." msgstr "A implementação padrão não faz nada." -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "Atributos" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "Atributos que são chamáveis a partir da instância do construtor:" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "Um objeto :class:`.EventManager`." -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -301,7 +317,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/pt_BR/LC_MESSAGES/usage/configuration.po b/locale/pt_BR/LC_MESSAGES/usage/configuration.po index 6fc5bb8dd8..953d35e6c7 100644 --- a/locale/pt_BR/LC_MESSAGES/usage/configuration.po +++ b/locale/pt_BR/LC_MESSAGES/usage/configuration.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Portuguese (Brazil) (https://app.transifex.com/sphinx-doc/teams/15434/pt_BR/)\n" @@ -593,17 +593,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "Exemplo:" @@ -1115,7 +1115,7 @@ msgstr "O texto alternativo de imagens é traduzido por padrão." #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "Permite e prefere um tipo definido." @@ -1493,10 +1493,10 @@ msgstr "" "o nome é chamável." #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." @@ -1506,10 +1506,10 @@ msgstr "" "individual." #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -2239,7 +2239,7 @@ msgstr "O tema padrão é agora :code-py:`'alabaster'`." #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -2320,7 +2320,7 @@ msgstr "Exibe números de linha usando a tag ````" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr ":code-py:`'inline'`" @@ -2690,7 +2690,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2700,7 +2700,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -3527,29 +3527,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3714,8 +3714,8 @@ msgstr "" "author, theme, toctree_only)``, onde os itens são:" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "*startdocname*" @@ -3728,7 +3728,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "*targetname*" @@ -3737,7 +3737,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "Nome de arquivo do arquivo LaTeX no diretório de saída." #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "*title*" @@ -3750,7 +3750,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "*author*" @@ -3770,7 +3770,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "*toctree_only*" @@ -3921,22 +3921,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3945,13 +3950,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3962,7 +3967,7 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " @@ -3972,7 +3977,7 @@ msgstr "" "determinada coluna, use ``>{\\noindent\\color{}}``, possivelmente " "além do acima." -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." @@ -3981,7 +3986,7 @@ msgstr "" "colunas, atualmente ignoram qualquer definição de coluna, linha ou cor de " "célula." -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3989,7 +3994,7 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" @@ -3999,7 +4004,7 @@ msgstr "" " uma tabela individual através da classe ``booktabs``, mas será necessário " "adicionar ``r'\\usepackage{booktabs}'`` ao preâmbulo do LaTeX." -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." @@ -4008,12 +4013,12 @@ msgstr "" "sem nenhum pacote extra (já que o Sphinx desde a versão 5.3.0 sempre carrega" " colortbl_)." -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -4021,13 +4026,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -4035,14 +4040,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -4050,13 +4055,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -4064,14 +4069,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -4081,7 +4086,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -4091,102 +4096,102 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "``manual``" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "``howto``" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "Opções para saída texto" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "Essas opções influenciam a saída texto." -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "Determina caracter usado como final de linha na saída texto." -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" @@ -4196,22 +4201,22 @@ msgstr "" "caracter é usado para cabeçalhos do primeiro nível, segundo caracter para " "segundo nível e assim sucessivamente." -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "Opções para saída página de manual" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "Essas opções influenciam a saída página manual." -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -4220,74 +4225,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "*name*" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "*description*" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "*authors*" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "*section*" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "Opções para saída TexInfo" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "Essas opções influenciam a saída Texinfo." -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -4295,7 +4300,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -4303,43 +4308,43 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" "Nome de arquivo (sem extensão) do arquivo Texinfo no diretório de saída." -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "*dir_entry*" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "O nome que vai aparecer no arquivo de menu de topo de nível ``DIR``." -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" "Um texto descritivo que vai aparecer no arquivo de menu de topo de nível " "``DIR``." -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "*category*" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." @@ -4347,7 +4352,7 @@ msgstr "" "Especifica a seção na qual esta entrada vai aparecer no arquivo de menu de " "topo de nível ``DIR``." -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -4355,144 +4360,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "Lista de nomes de documentos que serão anexados para todos manuais." -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "Chaves que podem ser sobrepostas são:" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "``'paragraphindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "``'exampleindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "``'preamble'``" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "Marcação TexInfo inserida próxima do início do arquivo." -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "``'copying'``" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "Opções para saída QtHelp" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "Opções para construtor linkcheck" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "o link no documento corresponde ao padrão de URI de origem e" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "o local de redirecionamento corresponde ao padrão de URI canônico." -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -4500,20 +4505,20 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." @@ -4521,7 +4526,7 @@ msgstr "" "Use :confval:`linkcheck_anchors_ignore_for_url` para verificar uma URL, mas " "pulando a verificação de se as âncoras existem." -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -4529,7 +4534,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -4537,80 +4542,80 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" "Passa informações de autenticação ao fazer uma construção ``linkcheck``." -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "*regex_pattern*" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "Uma expressão regular que corresponde a uma URI." -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "*auth_info*" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -4619,7 +4624,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4628,7 +4633,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4636,81 +4641,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "O valor é um dicionário que mapeia nome de cabeçalho para seu valor." -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "Opções para o domínio C" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4720,32 +4725,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "Opções para domínio C++" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4755,26 +4760,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "Opções para o domínio JavaScript" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "Opções para o domínio Python" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4782,36 +4787,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "Exemplos" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "Os exemplos abaixo usam a seguinte diretiva :rst:dir:`py:function`:" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4824,23 +4829,23 @@ msgstr "" "este último, o comprimento da assinatura ignora o comprimento da lista de " "parâmetros de tipo." -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4848,21 +4853,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "Agora també remove ````." -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "Opções Extensão" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/pt_BR/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/pt_BR/LC_MESSAGES/usage/extensions/autosectionlabel.po index c270dd3f88..b15fd2df3e 100644 --- a/locale/pt_BR/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/pt_BR/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Portuguese (Brazil) (https://app.transifex.com/sphinx-doc/teams/15434/pt_BR/)\n" @@ -25,19 +25,15 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" -":mod:`sphinx.ext.autosectionlabel` -- Permite referenciar seção usando seu " -"título" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" -"Essa extensão permite referenciar a ao título da seção. Isso afeta a regra " -"de referência (:rst:role:`ref`)." #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 msgid "For example::" @@ -61,7 +57,15 @@ msgstr "" msgid "Configuration" msgstr "Configuração" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "Type" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "Default" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -74,24 +78,19 @@ msgstr "" "``Introduction`` que aparece no documento ``index.rst``. Útil para evitar " "ambiguidade quando cabeçalho da seção aparece em diferentes documentos." -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -"Se definido, autosectionlabel escolhe as seções para rotulagem por sua " -"profundidade. Por exemplo, quando o conjunto 1 para " -"``autosectionlabel_maxdepth``, os rótulos são gerados apenas para as seções " -"de nível superior e as seções mais profundas não são rotuladas. O padrão é " -"``None`` (desativado)." -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "Depuração" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/ru/LC_MESSAGES/changes/index.po b/locale/ru/LC_MESSAGES/changes/index.po index 697430faf3..dfc03f404b 100644 --- a/locale/ru/LC_MESSAGES/changes/index.po +++ b/locale/ru/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: Georg Brandl , 2024\n" "Language-Team: Russian (https://app.transifex.com/sphinx-doc/teams/15434/ru/)\n" @@ -26,7 +26,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -310,11 +310,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/ru/LC_MESSAGES/extdev/builderapi.po b/locale/ru/LC_MESSAGES/extdev/builderapi.po index 672ec25273..c91a520103 100644 --- a/locale/ru/LC_MESSAGES/extdev/builderapi.po +++ b/locale/ru/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Russian (https://app.transifex.com/sphinx-doc/teams/15434/ru/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/ru/LC_MESSAGES/usage/configuration.po b/locale/ru/LC_MESSAGES/usage/configuration.po index d6403fe023..7f059e3ac9 100644 --- a/locale/ru/LC_MESSAGES/usage/configuration.po +++ b/locale/ru/LC_MESSAGES/usage/configuration.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: SeryiMysh , 2024\n" "Language-Team: Russian (https://app.transifex.com/sphinx-doc/teams/15434/ru/)\n" @@ -466,17 +466,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -925,7 +925,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1211,20 +1211,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1827,7 +1827,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1889,7 +1889,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2167,7 +2167,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2175,7 +2175,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2935,29 +2935,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3119,8 +3119,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3133,7 +3133,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3142,7 +3142,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3155,7 +3155,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3175,7 +3175,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3324,22 +3324,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3348,13 +3353,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3365,20 +3370,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3386,25 +3391,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3412,13 +3417,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3426,14 +3431,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3441,13 +3446,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3455,14 +3460,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3472,7 +3477,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3482,124 +3487,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3608,74 +3613,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3683,7 +3688,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3691,46 +3696,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3738,144 +3743,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3883,26 +3888,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3910,7 +3915,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3918,79 +3923,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3999,7 +4004,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4008,7 +4013,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4016,81 +4021,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4100,32 +4105,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4135,26 +4140,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4162,36 +4167,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "Примеры" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4199,23 +4204,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4223,21 +4228,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/ru/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/ru/LC_MESSAGES/usage/extensions/autosectionlabel.po index 509d7c4745..2dc9a0254e 100644 --- a/locale/ru/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/ru/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Russian (https://app.transifex.com/sphinx-doc/teams/15434/ru/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/sr/LC_MESSAGES/changes/index.po b/locale/sr/LC_MESSAGES/changes/index.po index 96daddbe98..287249763c 100644 --- a/locale/sr/LC_MESSAGES/changes/index.po +++ b/locale/sr/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: Vladimir Milovanović , 2024\n" "Language-Team: Serbian (https://app.transifex.com/sphinx-doc/teams/15434/sr/)\n" @@ -26,7 +26,7 @@ msgid "Changelog" msgstr "" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -310,11 +310,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/sr/LC_MESSAGES/extdev/builderapi.po b/locale/sr/LC_MESSAGES/extdev/builderapi.po index 516c03cc95..af551619c3 100644 --- a/locale/sr/LC_MESSAGES/extdev/builderapi.po +++ b/locale/sr/LC_MESSAGES/extdev/builderapi.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Language-Team: Serbian (https://app.transifex.com/sphinx-doc/teams/15434/sr/)\n" "MIME-Version: 1.0\n" @@ -140,11 +140,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -163,11 +168,6 @@ msgid "" "that need to be written." msgstr "" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -185,7 +185,11 @@ msgid "" "builders." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -197,8 +201,20 @@ msgid "" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" msgstr "" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring @@ -227,28 +243,28 @@ msgstr "" msgid "The default implementation does nothing." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -257,7 +273,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/sr/LC_MESSAGES/usage/configuration.po b/locale/sr/LC_MESSAGES/usage/configuration.po index 88cdf8de34..6ea2de13ca 100644 --- a/locale/sr/LC_MESSAGES/usage/configuration.po +++ b/locale/sr/LC_MESSAGES/usage/configuration.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: Vladimir Milovanović , 2023\n" "Language-Team: Serbian (https://app.transifex.com/sphinx-doc/teams/15434/sr/)\n" @@ -461,17 +461,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "" @@ -920,7 +920,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1206,20 +1206,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1822,7 +1822,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1884,7 +1884,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2162,7 +2162,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2170,7 +2170,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2930,29 +2930,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3114,8 +3114,8 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "" @@ -3128,7 +3128,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "" @@ -3137,7 +3137,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "" @@ -3150,7 +3150,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "" @@ -3170,7 +3170,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "" @@ -3319,22 +3319,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3343,13 +3348,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3360,20 +3365,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3381,25 +3386,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3407,13 +3412,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3421,14 +3426,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3436,13 +3441,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3450,14 +3455,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3467,7 +3472,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3477,124 +3482,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3603,74 +3608,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3678,7 +3683,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3686,46 +3691,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3733,144 +3738,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3878,26 +3883,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3905,7 +3910,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3913,79 +3918,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -3994,7 +3999,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4003,7 +4008,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4011,81 +4016,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4095,32 +4100,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4130,26 +4135,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4157,36 +4162,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "Примери" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4194,23 +4199,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4218,21 +4223,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/sr/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/sr/LC_MESSAGES/usage/extensions/autosectionlabel.po index d3db90202a..1557114faa 100644 --- a/locale/sr/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/sr/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Language-Team: Serbian (https://app.transifex.com/sphinx-doc/teams/15434/sr/)\n" "MIME-Version: 1.0\n" @@ -19,14 +19,14 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 @@ -46,7 +46,15 @@ msgstr "" msgid "Configuration" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -55,19 +63,19 @@ msgid "" "documents." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/locale/zh_CN/LC_MESSAGES/changes/index.po b/locale/zh_CN/LC_MESSAGES/changes/index.po index 836cce5f96..8dd861258f 100644 --- a/locale/zh_CN/LC_MESSAGES/changes/index.po +++ b/locale/zh_CN/LC_MESSAGES/changes/index.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:48+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: JY3, 2024\n" "Language-Team: Chinese (China) (https://app.transifex.com/sphinx-doc/teams/15434/zh_CN/)\n" @@ -27,7 +27,7 @@ msgid "Changelog" msgstr "更新日志" #: ../../sphinx/CHANGES.rst:2 -msgid "Release 8.1.0 (in development)" +msgid "Release 8.1.0 (released Oct 10, 2024)" msgstr "" #: ../../sphinx/CHANGES.rst:5 @@ -311,11 +311,26 @@ msgid "" "Khan" msgstr "" +#: ../../sphinx/CHANGES.rst:149 +msgid "" +"#12995: Significantly improve performance when building the search index for" +" Chinese languages. Patch by Adam Turner." +msgstr "" + #: ../../sphinx/CHANGES.rst:152 +msgid "" +"#12767: :py:meth:`.Builder.write` is typed as ``final``, meaning that the " +":event:`write-started` event may be relied upon by extensions. A new " +":py:meth:`.Builder.write_documents` method has been added to control how " +"documents are written. This is intended for builders that do not output a " +"file for each document. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:161 msgid "Testing" msgstr "测试" -#: ../../sphinx/CHANGES.rst:154 +#: ../../sphinx/CHANGES.rst:163 msgid "" "#12141: Migrate from the deprecated ``karma`` JavaScript test framework to " "the actively-maintained ``jasmine`` framework. Test coverage is unaffected." diff --git a/locale/zh_CN/LC_MESSAGES/extdev/builderapi.po b/locale/zh_CN/LC_MESSAGES/extdev/builderapi.po index 0412ac6d71..f993ed8667 100644 --- a/locale/zh_CN/LC_MESSAGES/extdev/builderapi.po +++ b/locale/zh_CN/LC_MESSAGES/extdev/builderapi.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-10 00:48+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-02-12 13:48+0000\n" "Last-Translator: wendi cao <651645601@qq.com>, 2020\n" "Language-Team: Chinese (China) (https://app.transifex.com/sphinx-doc/teams/15434/zh_CN/)\n" @@ -144,11 +144,16 @@ msgstr "" msgid "Write the doctree to a file, to be used as a cache by re-builds." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:44 -msgid "Overridable Methods" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write:1 +msgid "Write builder specific output files." msgstr "" #: ../../sphinx/doc/extdev/builderapi.rst:45 +msgid "Abstract Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:46 msgid "These must be implemented in builder sub-classes:" msgstr "" @@ -167,11 +172,6 @@ msgid "" "that need to be written." msgstr "如果生成器没有输出与源文件对应的单个文件，请在此处返回一个字符串。如果是，则返回需要写入的文件的迭代器。" -#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.prepare_writing:1 -msgid "A place where you can add logic before :meth:`write_doc` is run" -msgstr "在运行：meth:`write\\u doc`之前可以添加逻辑的地方" - #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.write_doc:1 msgid "Where you actually write something to the filesystem." @@ -189,7 +189,11 @@ msgid "" "builders." msgstr "*typ*可用于限定单个构建器的链接特性。" -#: ../../sphinx/doc/extdev/builderapi.rst:52 +#: ../../sphinx/doc/extdev/builderapi.rst:53 +msgid "Overridable Methods" +msgstr "" + +#: ../../sphinx/doc/extdev/builderapi.rst:54 msgid "These methods can be overridden in builder sub-classes:" msgstr "" @@ -201,10 +205,22 @@ msgid "" msgstr "加载必要的模板并执行初始化。默认实现什么也不做。" #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring -#: of sphinx.builders.Builder.write:1 -msgid "Write builder specific output files." +#: of sphinx.builders.Builder.write_documents:1 +msgid "Write all documents in *docnames*." msgstr "" +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.write_documents:3 +msgid "" +"This method can be overridden if a builder does not create output files for " +"each document." +msgstr "" + +#: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring +#: of sphinx.builders.Builder.prepare_writing:1 +msgid "A place where you can add logic before :meth:`write_doc` is run" +msgstr "在运行：meth:`write\\u doc`之前可以添加逻辑的地方" + #: ../../../../../../../opt/hostedtoolcache/Python/3.12.7/x64/lib/python3.12/site-packages/sphinx/builders/__init__.pydocstring #: of sphinx.builders.Builder.copy_assets:1 msgid "Where assets (images, static files, etc) are copied before writing" @@ -231,28 +247,28 @@ msgstr "完成构建过程。" msgid "The default implementation does nothing." msgstr "默认实现什么也不做。" -#: ../../sphinx/doc/extdev/builderapi.rst:61 +#: ../../sphinx/doc/extdev/builderapi.rst:64 msgid "Attributes" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:62 +#: ../../sphinx/doc/extdev/builderapi.rst:65 msgid "Attributes that are callable from the builder instance:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:66 +#: ../../sphinx/doc/extdev/builderapi.rst:69 msgid "An :class:`.EventManager` object." msgstr "An:类：`.EventManager`对象。" -#: ../../sphinx/doc/extdev/builderapi.rst:69 +#: ../../sphinx/doc/extdev/builderapi.rst:72 msgid "Overridable Attributes (extensions)" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:70 +#: ../../sphinx/doc/extdev/builderapi.rst:73 msgid "" "Builder sub-classes can set these attributes to support built-in extensions:" msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:74 +#: ../../sphinx/doc/extdev/builderapi.rst:77 msgid "" "By default, the :mod:`linkcode ` extension will only " "inject references for an ``html`` builder. The ``supported_linkcode`` " @@ -261,7 +277,7 @@ msgid "" "an expression which is compatible with :rst:dir:`only`." msgstr "" -#: ../../sphinx/doc/extdev/builderapi.rst:81 +#: ../../sphinx/doc/extdev/builderapi.rst:84 msgid "" "For example, if a builder was named ``custom-builder``, the following can be" " used:" diff --git a/locale/zh_CN/LC_MESSAGES/usage/configuration.po b/locale/zh_CN/LC_MESSAGES/usage/configuration.po index d9743e43b4..0c890c4147 100644 --- a/locale/zh_CN/LC_MESSAGES/usage/configuration.po +++ b/locale/zh_CN/LC_MESSAGES/usage/configuration.po @@ -15,7 +15,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-10-06 00:54+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-05-01 15:28+0000\n" "Last-Translator: Melia Lee , 2024\n" "Language-Team: Chinese (China) (https://app.transifex.com/sphinx-doc/teams/15434/zh_CN/)\n" @@ -465,17 +465,17 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2642 #: ../../sphinx/doc/usage/configuration.rst:2659 #: ../../sphinx/doc/usage/configuration.rst:2958 -#: ../../sphinx/doc/usage/configuration.rst:3466 -#: ../../sphinx/doc/usage/configuration.rst:3613 -#: ../../sphinx/doc/usage/configuration.rst:3682 -#: ../../sphinx/doc/usage/configuration.rst:3698 -#: ../../sphinx/doc/usage/configuration.rst:3732 -#: ../../sphinx/doc/usage/configuration.rst:3809 -#: ../../sphinx/doc/usage/configuration.rst:3882 -#: ../../sphinx/doc/usage/configuration.rst:3923 -#: ../../sphinx/doc/usage/configuration.rst:3950 -#: ../../sphinx/doc/usage/configuration.rst:3969 -#: ../../sphinx/doc/usage/configuration.rst:4008 +#: ../../sphinx/doc/usage/configuration.rst:3469 +#: ../../sphinx/doc/usage/configuration.rst:3616 +#: ../../sphinx/doc/usage/configuration.rst:3685 +#: ../../sphinx/doc/usage/configuration.rst:3701 +#: ../../sphinx/doc/usage/configuration.rst:3735 +#: ../../sphinx/doc/usage/configuration.rst:3812 +#: ../../sphinx/doc/usage/configuration.rst:3885 +#: ../../sphinx/doc/usage/configuration.rst:3926 +#: ../../sphinx/doc/usage/configuration.rst:3953 +#: ../../sphinx/doc/usage/configuration.rst:3972 +#: ../../sphinx/doc/usage/configuration.rst:4011 msgid "Example:" msgstr "举例如下：" @@ -924,7 +924,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:688 #: ../../sphinx/doc/usage/configuration.rst:1858 #: ../../sphinx/doc/usage/configuration.rst:2967 -#: ../../sphinx/doc/usage/configuration.rst:3475 +#: ../../sphinx/doc/usage/configuration.rst:3478 msgid "Permit and prefer a set type." msgstr "" @@ -1211,20 +1211,20 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1016 -#: ../../sphinx/doc/usage/configuration.rst:3898 -#: ../../sphinx/doc/usage/configuration.rst:3983 -#: ../../sphinx/doc/usage/configuration.rst:4028 -#: ../../sphinx/doc/usage/configuration.rst:4103 +#: ../../sphinx/doc/usage/configuration.rst:3901 +#: ../../sphinx/doc/usage/configuration.rst:3986 +#: ../../sphinx/doc/usage/configuration.rst:4031 +#: ../../sphinx/doc/usage/configuration.rst:4106 msgid "" "If a signature's length in characters exceeds the number set, each parameter" " within the signature will be displayed on an individual logical line." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1020 -#: ../../sphinx/doc/usage/configuration.rst:3902 -#: ../../sphinx/doc/usage/configuration.rst:3987 -#: ../../sphinx/doc/usage/configuration.rst:4032 -#: ../../sphinx/doc/usage/configuration.rst:4107 +#: ../../sphinx/doc/usage/configuration.rst:3905 +#: ../../sphinx/doc/usage/configuration.rst:3990 +#: ../../sphinx/doc/usage/configuration.rst:4035 +#: ../../sphinx/doc/usage/configuration.rst:4110 msgid "" "When :code-py:`None`, there is no maximum length and the entire signature " "will be displayed on a single logical line." @@ -1829,7 +1829,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1473 #: ../../sphinx/doc/usage/configuration.rst:2476 -#: ../../sphinx/doc/usage/configuration.rst:3569 +#: ../../sphinx/doc/usage/configuration.rst:3572 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific. The options understood by the :ref:`builtin" @@ -1891,7 +1891,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1540 #: ../../sphinx/doc/usage/configuration.rst:2744 #: ../../sphinx/doc/usage/configuration.rst:2991 -#: ../../sphinx/doc/usage/configuration.rst:3532 +#: ../../sphinx/doc/usage/configuration.rst:3535 msgid ":code-py:`'inline'`" msgstr "" @@ -2172,7 +2172,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1842 #: ../../sphinx/doc/usage/configuration.rst:2951 -#: ../../sphinx/doc/usage/configuration.rst:3459 +#: ../../sphinx/doc/usage/configuration.rst:3462 msgid "" "If True, generate domain-specific indices in addition to the general index. " "For e.g. the Python domain, this is the global module index." @@ -2180,7 +2180,7 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:1845 #: ../../sphinx/doc/usage/configuration.rst:2954 -#: ../../sphinx/doc/usage/configuration.rst:3462 +#: ../../sphinx/doc/usage/configuration.rst:3465 msgid "" "This value can be a Boolean or a list of index names that should be " "generated. To find out the index name for a specific index, look at the HTML" @@ -2942,29 +2942,29 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2745 -#: ../../sphinx/doc/usage/configuration.rst:3533 +#: ../../sphinx/doc/usage/configuration.rst:3536 msgid "Display URLs inline in parentheses." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2746 #: ../../sphinx/doc/usage/configuration.rst:2989 -#: ../../sphinx/doc/usage/configuration.rst:3528 +#: ../../sphinx/doc/usage/configuration.rst:3531 msgid ":code-py:`'footnote'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2747 -#: ../../sphinx/doc/usage/configuration.rst:3529 +#: ../../sphinx/doc/usage/configuration.rst:3532 msgid "Display URLs in footnotes." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2748 #: ../../sphinx/doc/usage/configuration.rst:2987 -#: ../../sphinx/doc/usage/configuration.rst:3530 +#: ../../sphinx/doc/usage/configuration.rst:3533 msgid ":code-py:`'no'`" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2749 -#: ../../sphinx/doc/usage/configuration.rst:3531 +#: ../../sphinx/doc/usage/configuration.rst:3534 msgid "Do not display URLs." msgstr "" @@ -3128,8 +3128,8 @@ msgstr "" "theme, toctree_only)”, 其中的项目是:" #: ../../sphinx/doc/usage/configuration.rst:2869 -#: ../../sphinx/doc/usage/configuration.rst:3324 -#: ../../sphinx/doc/usage/configuration.rst:3395 +#: ../../sphinx/doc/usage/configuration.rst:3327 +#: ../../sphinx/doc/usage/configuration.rst:3398 msgid "*startdocname*" msgstr "*startdocname*" @@ -3142,7 +3142,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2877 -#: ../../sphinx/doc/usage/configuration.rst:3403 +#: ../../sphinx/doc/usage/configuration.rst:3406 msgid "*targetname*" msgstr "*targetname*" @@ -3151,7 +3151,7 @@ msgid "File name of the LaTeX file in the output directory." msgstr "输出目录中LaTeX文件的文件名。" #: ../../sphinx/doc/usage/configuration.rst:2880 -#: ../../sphinx/doc/usage/configuration.rst:3406 +#: ../../sphinx/doc/usage/configuration.rst:3409 msgid "*title*" msgstr "*title*" @@ -3164,7 +3164,7 @@ msgid "" msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2888 -#: ../../sphinx/doc/usage/configuration.rst:3413 +#: ../../sphinx/doc/usage/configuration.rst:3416 msgid "*author*" msgstr "*author*" @@ -3184,7 +3184,7 @@ msgid "LaTeX theme. See :confval:`latex_theme`." msgstr "" #: ../../sphinx/doc/usage/configuration.rst:2898 -#: ../../sphinx/doc/usage/configuration.rst:3428 +#: ../../sphinx/doc/usage/configuration.rst:3431 msgid "*toctree_only*" msgstr "*toctree_only*" @@ -3333,22 +3333,27 @@ msgstr "" #: ../../sphinx/doc/usage/configuration.rst:3049 msgid "" -"Each table can override the global style via ``:class:`` option, or ``.. " -"rst-class::`` for no-directive tables (cf. :ref:`table-directives`). " +"To customise the styles for a table, use the ``:class:`` option if the table" +" is defined using a directive, or otherwise insert a :ref:`rst-class " +"` directive before the table (cf. :ref:`table-directives`)." +msgstr "" + +#: ../../sphinx/doc/usage/configuration.rst:3054 +msgid "" "Currently recognised classes are ``booktabs``, ``borderless``, ``standard``," " ``colorrows``, ``nocolorrows``. The latter two can be combined with any of " "the first three. The ``standard`` class produces tables with both horizontal" " and vertical lines (as has been the default so far with Sphinx)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3058 +#: ../../sphinx/doc/usage/configuration.rst:3061 msgid "" "A single-row multi-column merged cell will obey the row colour, if it is " "set. See also ``TableMergeColor{Header,Odd,Even}`` in the " ":ref:`latexsphinxsetup` section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3065 +#: ../../sphinx/doc/usage/configuration.rst:3068 msgid "" "It is hard-coded in LaTeX that a single cell will obey the row colour even " "if there is a column colour set via :code-tex:`\\\\columncolor` from a " @@ -3357,13 +3362,13 @@ msgid "" " like this:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3075 +#: ../../sphinx/doc/usage/configuration.rst:3078 msgid "" "Sphinx also provides :code-tex:`\\\\sphinxcolorblend`, which however " "requires the xcolor_ package. Here is an example:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3083 +#: ../../sphinx/doc/usage/configuration.rst:3086 msgid "" "It means that in this column, the row colours will be slightly tinted by " "red; refer to xcolor_ documentation for more on the syntax of its :code-" @@ -3374,20 +3379,20 @@ msgid "" "in PDF format." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3095 +#: ../../sphinx/doc/usage/configuration.rst:3098 msgid "" "If you want to use a special colour for the *contents* of the cells of a " "given column use ``>{\\noindent\\color{}}``, possibly in addition to " "the above." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3099 +#: ../../sphinx/doc/usage/configuration.rst:3102 msgid "" "Multi-row merged cells, whether single column or multi-column currently " "ignore any set column, row, or cell colour." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3102 +#: ../../sphinx/doc/usage/configuration.rst:3105 msgid "" "It is possible for a simple cell to set a custom colour via the :dudir:`raw`" " directive and the :code-tex:`\\\\cellcolor` LaTeX command used anywhere in " @@ -3395,25 +3400,25 @@ msgid "" "whatever its kind." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3110 +#: ../../sphinx/doc/usage/configuration.rst:3113 msgid "" "In a document not using ``'booktabs'`` globally, it is possible to style an " "individual table via the ``booktabs`` class, but it will be necessary to add" " ``r'\\usepackage{booktabs}'`` to the LaTeX preamble." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3115 +#: ../../sphinx/doc/usage/configuration.rst:3118 msgid "" "On the other hand one can use ``colorrows`` class for individual tables with" " no extra package (as Sphinx since 5.3.0 always loads colortbl_)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3126 +#: ../../sphinx/doc/usage/configuration.rst:3129 msgid "" "Modify default from :code-py:`[]` to :code-py:`['booktabs', 'colorrows']`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3132 +#: ../../sphinx/doc/usage/configuration.rst:3135 msgid "" "Use Xindy_ to prepare the index of general terms. By default, the LaTeX " "builder uses :program:`makeindex` for preparing the index of general terms ." @@ -3421,13 +3426,13 @@ msgid "" "correctly for the :confval:`language`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3140 +#: ../../sphinx/doc/usage/configuration.rst:3143 msgid "" "This option is ignored if :confval:`latex_engine` is :code-py:`'platex'` " "(Japanese documents; :program:`mendex` replaces :program:`makeindex` then)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3144 +#: ../../sphinx/doc/usage/configuration.rst:3147 msgid "" "The default is :code-py:`True` for :code-py:`'xelatex'` or :code-" "py:`'lualatex'` as :program:`makeindex` creates ``.ind`` files containing " @@ -3435,14 +3440,14 @@ msgid "" "ASCII character. With :code-py:`'lualatex'` this then breaks the PDF build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3151 +#: ../../sphinx/doc/usage/configuration.rst:3154 msgid "" "The default is :code-py:`False` for :code-py:`'pdflatex'`, but :code-" "py:`True` is recommended for non-English documents as soon as some indexed " "terms use non-ASCII characters from the language script." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3155 +#: ../../sphinx/doc/usage/configuration.rst:3158 msgid "" "Sphinx adds some dedicated support to the :program:`xindy` base distribution" " for using :code-py:`'pdflatex'` engine with Cyrillic scripts. With both " @@ -3450,13 +3455,13 @@ msgid "" "indexing of Latin names correctly, even those having diacritics." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3169 +#: ../../sphinx/doc/usage/configuration.rst:3172 msgid "" ":ref:`See the full documentation for latex_elements " "`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3175 +#: ../../sphinx/doc/usage/configuration.rst:3178 msgid "" "A dictionary mapping :code-py:`'howto'` and :code-py:`'manual'` to names of " "real document classes that will be used as the base for the two Sphinx " @@ -3464,14 +3469,14 @@ msgid "" ":code-py:`'report'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3183 +#: ../../sphinx/doc/usage/configuration.rst:3186 msgid "" "In Japanese documentation (:confval:`language` is :code-py:`'ja'`), by " "default :code-py:`'jreport'` is used for :code-py:`'howto'` and :code-" "py:`'jsbook'` for :code-py:`'manual'`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3192 +#: ../../sphinx/doc/usage/configuration.rst:3195 msgid "" "A list of file names, relative to the :term:`configuration directory`, to " "copy to the build directory when building LaTeX output. This is useful to " @@ -3481,7 +3486,7 @@ msgid "" "not be listed there." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3200 +#: ../../sphinx/doc/usage/configuration.rst:3203 msgid "" "Filenames with the ``.tex`` extension will be automatically handed over to " "the PDF build process triggered by :option:`sphinx-build -M latexpdf " @@ -3491,124 +3496,124 @@ msgid "" "tex:`\\\\input{}` macro accordingly." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3211 +#: ../../sphinx/doc/usage/configuration.rst:3214 msgid "This overrides the files provided from Sphinx such as ``sphinx.sty``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3218 +#: ../../sphinx/doc/usage/configuration.rst:3221 msgid "" "The \"theme\" that the LaTeX output should use. It is a collection of " "settings for LaTeX output (e.g. document class, top level sectioning unit " "and so on)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3222 +#: ../../sphinx/doc/usage/configuration.rst:3225 msgid "The bundled first-party LaTeX themes are *manual* and *howto*:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3224 +#: ../../sphinx/doc/usage/configuration.rst:3227 msgid "``manual``" msgstr "``manual``" -#: ../../sphinx/doc/usage/configuration.rst:3225 +#: ../../sphinx/doc/usage/configuration.rst:3228 msgid "" "A LaTeX theme for writing a manual. It imports the ``report`` document class" " (Japanese documents use ``jsbook``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3229 +#: ../../sphinx/doc/usage/configuration.rst:3232 msgid "``howto``" msgstr "``howto``" -#: ../../sphinx/doc/usage/configuration.rst:3230 +#: ../../sphinx/doc/usage/configuration.rst:3233 msgid "" "A LaTeX theme for writing an article. It imports the ``article`` document " "class (Japanese documents use ``jreport``). :confval:`latex_appendices` is " "only available for this theme." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3241 +#: ../../sphinx/doc/usage/configuration.rst:3244 msgid "" "A dictionary of options that influence the look and feel of the selected " "theme. These are theme-specific." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3251 +#: ../../sphinx/doc/usage/configuration.rst:3254 msgid "" "A list of paths that contain custom LaTeX themes as subdirectories. Relative" " paths are taken as relative to the :term:`configuration directory`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3260 +#: ../../sphinx/doc/usage/configuration.rst:3263 msgid "Options for text output" msgstr "文本输出选项" -#: ../../sphinx/doc/usage/configuration.rst:3262 +#: ../../sphinx/doc/usage/configuration.rst:3265 msgid "These options influence text output." msgstr "这些选项会影响文本输出。" -#: ../../sphinx/doc/usage/configuration.rst:3268 +#: ../../sphinx/doc/usage/configuration.rst:3271 msgid "Include section numbers in text output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3276 +#: ../../sphinx/doc/usage/configuration.rst:3279 msgid "Determines which end-of-line character(s) are used in text output." msgstr "确定在文本输出中使用哪个行尾字符。" -#: ../../sphinx/doc/usage/configuration.rst:3278 +#: ../../sphinx/doc/usage/configuration.rst:3281 msgid ":code-py:`'unix'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3279 +#: ../../sphinx/doc/usage/configuration.rst:3282 msgid "Use Unix-style line endings (``\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3280 +#: ../../sphinx/doc/usage/configuration.rst:3283 msgid ":code-py:`'windows'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3281 +#: ../../sphinx/doc/usage/configuration.rst:3284 msgid "Use Windows-style line endings (``\\r\\n``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3282 +#: ../../sphinx/doc/usage/configuration.rst:3285 msgid ":code-py:`'native'`" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3283 +#: ../../sphinx/doc/usage/configuration.rst:3286 msgid "" "Use the line ending style of the platform the documentation is built on." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3291 +#: ../../sphinx/doc/usage/configuration.rst:3294 msgid "" "Suffix for section numbers in text output. Set to :code-py:`' '` to suppress" " the final dot on section numbers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3300 +#: ../../sphinx/doc/usage/configuration.rst:3303 msgid "" "A string of 7 characters that should be used for underlining sections. The " "first character is used for first-level headings, the second for second-" "level headings and so on." msgstr "一个7个字符的字符串, 应该用于下划线部分。第一个字符用于第一级标题, 第二个字符用于第二级标题, 依此类推。" -#: ../../sphinx/doc/usage/configuration.rst:3310 +#: ../../sphinx/doc/usage/configuration.rst:3313 msgid "Options for manual page output" msgstr "手动页面输出选项" -#: ../../sphinx/doc/usage/configuration.rst:3312 +#: ../../sphinx/doc/usage/configuration.rst:3315 msgid "These options influence manual page output." msgstr "这些选项会影响手动页面输出。" -#: ../../sphinx/doc/usage/configuration.rst:3318 +#: ../../sphinx/doc/usage/configuration.rst:3321 msgid "" "This value determines how to group the document tree into manual pages. It " "must be a list of tuples ``(startdocname, name, description, authors, " "section)``, where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3325 +#: ../../sphinx/doc/usage/configuration.rst:3328 msgid "" "String that specifies the :term:`document name` of the manual page's master " "document. All documents referenced by the *startdoc* document in ToC trees " @@ -3617,74 +3622,74 @@ msgid "" "here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3332 +#: ../../sphinx/doc/usage/configuration.rst:3335 msgid "*name*" msgstr "*name*" -#: ../../sphinx/doc/usage/configuration.rst:3333 +#: ../../sphinx/doc/usage/configuration.rst:3336 msgid "" "Name of the manual page. This should be a short string without spaces or " "special characters. It is used to determine the file name as well as the " "name of the manual page (in the NAME section)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3338 -#: ../../sphinx/doc/usage/configuration.rst:3421 +#: ../../sphinx/doc/usage/configuration.rst:3341 +#: ../../sphinx/doc/usage/configuration.rst:3424 msgid "*description*" msgstr "*description*" -#: ../../sphinx/doc/usage/configuration.rst:3339 +#: ../../sphinx/doc/usage/configuration.rst:3342 msgid "" "Description of the manual page. This is used in the NAME section. Can be an " "empty string if you do not want to automatically generate the NAME section." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3344 +#: ../../sphinx/doc/usage/configuration.rst:3347 msgid "*authors*" msgstr "*authors*" -#: ../../sphinx/doc/usage/configuration.rst:3345 +#: ../../sphinx/doc/usage/configuration.rst:3348 msgid "" "A list of strings with authors, or a single string. Can be an empty string " "or list if you do not want to automatically generate an AUTHORS section in " "the manual page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3349 +#: ../../sphinx/doc/usage/configuration.rst:3352 msgid "*section*" msgstr "*section*" -#: ../../sphinx/doc/usage/configuration.rst:3350 +#: ../../sphinx/doc/usage/configuration.rst:3353 msgid "" "The manual page section. Used for the output file name as well as in the " "manual page header." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3359 +#: ../../sphinx/doc/usage/configuration.rst:3362 msgid "Add URL addresses after links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3367 +#: ../../sphinx/doc/usage/configuration.rst:3370 msgid "Make a section directory on build man page." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3371 +#: ../../sphinx/doc/usage/configuration.rst:3374 msgid "The default is now :code-py:`False` (previously :code-py:`True`)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3374 +#: ../../sphinx/doc/usage/configuration.rst:3377 msgid "Revert the change in the default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3381 +#: ../../sphinx/doc/usage/configuration.rst:3384 msgid "Options for Texinfo output" msgstr "Texinfo输出的选项" -#: ../../sphinx/doc/usage/configuration.rst:3383 +#: ../../sphinx/doc/usage/configuration.rst:3386 msgid "These options influence Texinfo output." msgstr "这些选项会影响Texinfo输出。" -#: ../../sphinx/doc/usage/configuration.rst:3389 +#: ../../sphinx/doc/usage/configuration.rst:3392 msgid "" "This value determines how to group the document tree into Texinfo source " "files. It must be a list of tuples ``(startdocname, targetname, title, " @@ -3692,7 +3697,7 @@ msgid "" "are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3396 +#: ../../sphinx/doc/usage/configuration.rst:3399 msgid "" "String that specifies the :term:`document name` of the Texinfo file's master" " document. All documents referenced by the *startdoc* document in ToC trees " @@ -3700,46 +3705,46 @@ msgid "" " document for your Texinfo build, provide your :confval:`master_doc` here.)" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3404 +#: ../../sphinx/doc/usage/configuration.rst:3407 msgid "File name (no extension) of the Texinfo file in the output directory." msgstr "输出目录中Texinfo文件的文件名（无扩展名）。" -#: ../../sphinx/doc/usage/configuration.rst:3407 +#: ../../sphinx/doc/usage/configuration.rst:3410 msgid "" "Texinfo document title. Can be empty to use the title of the *startdoc* " "document. Inserted as Texinfo markup, so special characters like ``@`` and " "``{}`` will need to be escaped to be inserted literally." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3414 +#: ../../sphinx/doc/usage/configuration.rst:3417 msgid "" "Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to " "separate multiple authors, as in: ``'John@*Sarah'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3418 +#: ../../sphinx/doc/usage/configuration.rst:3421 msgid "*dir_entry*" msgstr "*dir_entry*" -#: ../../sphinx/doc/usage/configuration.rst:3419 +#: ../../sphinx/doc/usage/configuration.rst:3422 msgid "The name that will appear in the top-level ``DIR`` menu file." msgstr "将出现在顶级“DIR”菜单文件中的名称。" -#: ../../sphinx/doc/usage/configuration.rst:3422 +#: ../../sphinx/doc/usage/configuration.rst:3425 msgid "Descriptive text to appear in the top-level ``DIR`` menu file." msgstr "描述性文本出现在顶级“DIR”菜单文件中。" -#: ../../sphinx/doc/usage/configuration.rst:3424 +#: ../../sphinx/doc/usage/configuration.rst:3427 msgid "*category*" msgstr "*category*" -#: ../../sphinx/doc/usage/configuration.rst:3425 +#: ../../sphinx/doc/usage/configuration.rst:3428 msgid "" "Specifies the section which this entry will appear in the top-level ``DIR`` " "menu file." msgstr "指定此条目将出现在顶级“DIR”菜单文件中的部分。" -#: ../../sphinx/doc/usage/configuration.rst:3429 +#: ../../sphinx/doc/usage/configuration.rst:3432 msgid "" "Must be :code-py:`True` or :code-py:`False`. If True, the *startdoc* " "document itself is not included in the output, only the documents referenced" @@ -3747,144 +3752,144 @@ msgid "" "master document that shows up in the HTML, but not the Texinfo output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3441 +#: ../../sphinx/doc/usage/configuration.rst:3444 msgid "A list of document names to append as an appendix to all manuals." msgstr "要作为所有手册的附录附加的文档名称列表。" -#: ../../sphinx/doc/usage/configuration.rst:3449 +#: ../../sphinx/doc/usage/configuration.rst:3452 msgid "" "Generate inline references in a document. Disabling inline references can " "make an info file more readable with a stand-alone reader (``info``)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3482 +#: ../../sphinx/doc/usage/configuration.rst:3485 msgid "" "A dictionary that contains Texinfo snippets that override those that Sphinx " "usually puts into the generated ``.texi`` files." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3485 +#: ../../sphinx/doc/usage/configuration.rst:3488 msgid "Keys that you may want to override include:" msgstr "您可能想要覆盖的键包括：" -#: ../../sphinx/doc/usage/configuration.rst:3487 +#: ../../sphinx/doc/usage/configuration.rst:3490 msgid "``'paragraphindent'``" msgstr "``'paragraphindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3488 +#: ../../sphinx/doc/usage/configuration.rst:3491 msgid "" "Number of spaces to indent the first line of each paragraph, default ``2``. " "Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3492 +#: ../../sphinx/doc/usage/configuration.rst:3495 msgid "``'exampleindent'``" msgstr "``'exampleindent'``" -#: ../../sphinx/doc/usage/configuration.rst:3493 +#: ../../sphinx/doc/usage/configuration.rst:3496 msgid "" "Number of spaces to indent the lines for examples or literal blocks, default" " ``4``. Specify ``0`` for no indentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3497 +#: ../../sphinx/doc/usage/configuration.rst:3500 msgid "``'preamble'``" msgstr "``“序言”``" -#: ../../sphinx/doc/usage/configuration.rst:3498 +#: ../../sphinx/doc/usage/configuration.rst:3501 msgid "Texinfo markup inserted near the beginning of the file." msgstr "Texinfo标记插入文件的开头附近。" -#: ../../sphinx/doc/usage/configuration.rst:3500 +#: ../../sphinx/doc/usage/configuration.rst:3503 msgid "``'copying'``" msgstr "``'copying'``" -#: ../../sphinx/doc/usage/configuration.rst:3501 +#: ../../sphinx/doc/usage/configuration.rst:3504 msgid "" "Texinfo markup inserted within the ``@copying`` block and displayed after " "the title. The default value consists of a simple title page identifying the" " project." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3505 +#: ../../sphinx/doc/usage/configuration.rst:3508 msgid "" "Keys that are set by other options and therefore should not be overridden " "are ``'author'``, ``'body'``, ``'date'``, ``'direntry'`` ``'filename'``, " "``'project'``, ``'release'``, and ``'title'``." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3516 +#: ../../sphinx/doc/usage/configuration.rst:3519 msgid "" "Do not generate a ``@detailmenu`` in the \"Top\" node's menu containing " "entries for each sub-node in the document." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3525 +#: ../../sphinx/doc/usage/configuration.rst:3528 msgid "" "Control how to display URL addresses. The setting can have the following " "values:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3541 +#: ../../sphinx/doc/usage/configuration.rst:3544 msgid "Options for QtHelp output" msgstr "QtHelp输出的选项" -#: ../../sphinx/doc/usage/configuration.rst:3543 +#: ../../sphinx/doc/usage/configuration.rst:3546 msgid "" "These options influence qthelp output. This builder derives from the HTML " "builder, so the HTML options also apply where appropriate." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3551 +#: ../../sphinx/doc/usage/configuration.rst:3554 msgid "The basename for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3557 +#: ../../sphinx/doc/usage/configuration.rst:3560 msgid "The namespace for the qthelp file." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3563 +#: ../../sphinx/doc/usage/configuration.rst:3566 msgid "The HTML theme for the qthelp output." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3577 +#: ../../sphinx/doc/usage/configuration.rst:3580 msgid "Options for XML output" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3583 +#: ../../sphinx/doc/usage/configuration.rst:3586 msgid "Pretty-print the XML." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3589 +#: ../../sphinx/doc/usage/configuration.rst:3592 msgid "Options for the linkcheck builder" msgstr "linkcheck生成器的选项" -#: ../../sphinx/doc/usage/configuration.rst:3592 +#: ../../sphinx/doc/usage/configuration.rst:3595 msgid "Filtering" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3594 +#: ../../sphinx/doc/usage/configuration.rst:3597 msgid "" "These options control which links the *linkcheck* builder checks, and which " "failures and redirects it ignores." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3601 +#: ../../sphinx/doc/usage/configuration.rst:3604 msgid "" "A dictionary that maps a pattern of the source URI to a pattern of the " "canonical URI. The *linkcheck* builder treats the redirected link as " "\"working\" when:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3605 +#: ../../sphinx/doc/usage/configuration.rst:3608 msgid "the link in the document matches the source URI pattern, and" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3606 +#: ../../sphinx/doc/usage/configuration.rst:3609 msgid "the redirect location matches the canonical URI pattern." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3608 +#: ../../sphinx/doc/usage/configuration.rst:3611 msgid "" "The *linkcheck* builder will emit a warning when it finds redirected links " "that don't meet the rules above. It can be useful to detect unexpected " @@ -3892,26 +3897,26 @@ msgid "" "--fail-on-warning>`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3629 +#: ../../sphinx/doc/usage/configuration.rst:3632 msgid "" "Check the validity of ``#anchor``\\ s in links. Since this requires " "downloading the whole document, it is considerably slower when enabled." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3639 +#: ../../sphinx/doc/usage/configuration.rst:3642 msgid "" "A list of regular expressions that match anchors that the *linkcheck* " "builder should skip when checking the validity of anchors in links. For " "example, this allows skipping anchors added by a website's JavaScript." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3644 +#: ../../sphinx/doc/usage/configuration.rst:3647 msgid "" "Use :confval:`linkcheck_anchors_ignore_for_url` to check a URL, but skip " "verifying that the anchors exist." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3648 +#: ../../sphinx/doc/usage/configuration.rst:3651 msgid "" "If you want to ignore anchors of a specific page or of pages that match a " "specific pattern (but still check occurrences of the same page(s) that don't" @@ -3919,7 +3924,7 @@ msgid "" "follows:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3666 +#: ../../sphinx/doc/usage/configuration.rst:3669 msgid "" "A list or tuple of regular expressions matching URLs for which the " "*linkcheck* builder should not check the validity of anchors. This allows " @@ -3927,79 +3932,79 @@ msgid "" " of the page itself." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3677 +#: ../../sphinx/doc/usage/configuration.rst:3680 msgid "" "A list of regular expressions that match documents in which the *linkcheck* " "builder should not check the validity of links. This can be used for " "permitting link decay in legacy or historical sections of the documentation." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3695 +#: ../../sphinx/doc/usage/configuration.rst:3698 msgid "" "A list of regular expressions that match URIs that should not be checked " "when doing a ``linkcheck`` build." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3707 +#: ../../sphinx/doc/usage/configuration.rst:3710 msgid "HTTP Requests" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3709 +#: ../../sphinx/doc/usage/configuration.rst:3712 msgid "" "These options control how the *linkcheck* builder makes HTTP requests, " "including how it handles redirects and authentication, and the number of " "workers to use." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3717 +#: ../../sphinx/doc/usage/configuration.rst:3720 msgid "Pass authentication information when doing a ``linkcheck`` build." msgstr "在进行``linkcheck`` 构建时提供身份验证信息。" -#: ../../sphinx/doc/usage/configuration.rst:3719 +#: ../../sphinx/doc/usage/configuration.rst:3722 msgid "" "A list of :code-py:`(regex_pattern, auth_info)` tuples where the items are:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3721 +#: ../../sphinx/doc/usage/configuration.rst:3724 msgid "*regex_pattern*" msgstr "*regex_pattern*" -#: ../../sphinx/doc/usage/configuration.rst:3722 +#: ../../sphinx/doc/usage/configuration.rst:3725 msgid "A regular expression that matches a URI." msgstr "匹配URI的正则表达式。" -#: ../../sphinx/doc/usage/configuration.rst:3723 +#: ../../sphinx/doc/usage/configuration.rst:3726 msgid "*auth_info*" msgstr "*auth_info*" -#: ../../sphinx/doc/usage/configuration.rst:3724 +#: ../../sphinx/doc/usage/configuration.rst:3727 msgid "" "Authentication information to use for that URI. The value can be anything " "that is understood by the ``requests`` library (see :ref:`requests " "authentication ` for details)." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3728 +#: ../../sphinx/doc/usage/configuration.rst:3731 msgid "" "The *linkcheck* builder will use the first matching ``auth_info`` value it " "can find in the :confval:`!linkcheck_auth` list, so values earlier in the " "list have higher priority." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3747 +#: ../../sphinx/doc/usage/configuration.rst:3750 msgid "" "When a webserver responds with an HTTP 401 (unauthorised) response, the " "current default behaviour of the *linkcheck* builder is to treat the link as" " \"broken\". To change that behaviour, set this option to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3752 +#: ../../sphinx/doc/usage/configuration.rst:3755 msgid "" "The default value for this option changed to :code-py:`False`, meaning HTTP " "401 responses to checked hyperlinks are treated as \"broken\" by default." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3763 +#: ../../sphinx/doc/usage/configuration.rst:3766 msgid "" "The *linkcheck* builder may issue a large number of requests to the same " "site over a short period of time. This setting controls the builder " @@ -4008,7 +4013,7 @@ msgid "" "each attempt before recording a failure." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3770 +#: ../../sphinx/doc/usage/configuration.rst:3773 msgid "" "The *linkcheck* builder always respects a server's direction of when to " "retry (using the `Retry-After`_ header). Otherwise, ``linkcheck`` waits for " @@ -4017,7 +4022,7 @@ msgid "" "(in seconds). Custom timeouts should be given as a number of seconds." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3785 +#: ../../sphinx/doc/usage/configuration.rst:3788 msgid "" "If :confval:`linkcheck_timeout` expires while waiting for a response from a " "hyperlink, the *linkcheck* builder will report the link as a ``timeout`` by " @@ -4025,81 +4030,81 @@ msgid "" ":confval:`linkcheck_report_timeouts_as_broken` to :code-py:`True`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3790 +#: ../../sphinx/doc/usage/configuration.rst:3793 msgid "" "The default value for this option changed to :code-py:`False`, meaning " "timeouts that occur while checking hyperlinks will be reported using the new" " 'timeout' status code." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3801 +#: ../../sphinx/doc/usage/configuration.rst:3804 msgid "A dictionary that maps URL (without paths) to HTTP request headers." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3803 +#: ../../sphinx/doc/usage/configuration.rst:3806 msgid "" "The key is a URL base string like :code-py:`'https://www.sphinx-doc.org/'`. " "To specify headers for other hosts, :code-py:`\"*\"` can be used. It matches" " all hosts only when the URL does not match other settings." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3807 +#: ../../sphinx/doc/usage/configuration.rst:3810 msgid "The value is a dictionary that maps header name to its value." msgstr "该值是一个将标题名称映射到其值的字典。" -#: ../../sphinx/doc/usage/configuration.rst:3829 +#: ../../sphinx/doc/usage/configuration.rst:3832 msgid "" "The number of times the *linkcheck* builder will attempt to check a URL " "before declaring it broken." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3838 +#: ../../sphinx/doc/usage/configuration.rst:3841 msgid "" "The duration, in seconds, that the *linkcheck* builder will wait for a " "response after each hyperlink request." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3847 +#: ../../sphinx/doc/usage/configuration.rst:3850 msgid "The number of worker threads to use when checking links." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3853 +#: ../../sphinx/doc/usage/configuration.rst:3856 msgid "Domain options" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3859 +#: ../../sphinx/doc/usage/configuration.rst:3862 msgid "Options for the C domain" msgstr "C域选项" -#: ../../sphinx/doc/usage/configuration.rst:3867 +#: ../../sphinx/doc/usage/configuration.rst:3870 msgid "A list of identifiers to be recognised as keywords by the C parser." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3870 +#: ../../sphinx/doc/usage/configuration.rst:3873 msgid ":confval:`!c_extra_keywords` can now be a set." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3877 +#: ../../sphinx/doc/usage/configuration.rst:3880 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-c:`#define` has been " "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3891 +#: ../../sphinx/doc/usage/configuration.rst:3894 msgid ":confval:`!c_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3905 -#: ../../sphinx/doc/usage/configuration.rst:3990 -#: ../../sphinx/doc/usage/configuration.rst:4035 -#: ../../sphinx/doc/usage/configuration.rst:4110 +#: ../../sphinx/doc/usage/configuration.rst:3908 +#: ../../sphinx/doc/usage/configuration.rst:3993 +#: ../../sphinx/doc/usage/configuration.rst:4038 +#: ../../sphinx/doc/usage/configuration.rst:4113 msgid "" "This is a domain-specific setting, overriding " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3914 +#: ../../sphinx/doc/usage/configuration.rst:3917 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4109,32 +4114,32 @@ msgid "" "been used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3932 +#: ../../sphinx/doc/usage/configuration.rst:3935 msgid ":confval:`!c_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3939 +#: ../../sphinx/doc/usage/configuration.rst:3942 msgid "Options for the C++ domain" msgstr "C++ 域选项" -#: ../../sphinx/doc/usage/configuration.rst:3945 +#: ../../sphinx/doc/usage/configuration.rst:3948 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes. For example, this can be used when :code-cpp:`#define` has been" " used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3959 +#: ../../sphinx/doc/usage/configuration.rst:3962 msgid ":confval:`!cpp_id_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3966 +#: ../../sphinx/doc/usage/configuration.rst:3969 msgid "" "A list of prefixes that will be ignored when sorting C++ objects in the " "global index." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:3999 +#: ../../sphinx/doc/usage/configuration.rst:4002 msgid "" "A sequence of strings that the parser should additionally accept as " "attributes with one argument. That is, if ``my_align_as`` is in the list, " @@ -4144,26 +4149,26 @@ msgid "" "used for attributes, for portability." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4017 +#: ../../sphinx/doc/usage/configuration.rst:4020 msgid ":confval:`!cpp_paren_attributes` can now be a tuple." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4022 +#: ../../sphinx/doc/usage/configuration.rst:4025 msgid "Options for the Javascript domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4042 +#: ../../sphinx/doc/usage/configuration.rst:4045 msgid "Options for the Python domain" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4048 +#: ../../sphinx/doc/usage/configuration.rst:4051 msgid "" "A boolean that decides whether module names are prepended to all " ":term:`object` names (for object types where a \"module\" of some kind is " "defined), e.g. for :rst:dir:`py:function` directives." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4057 +#: ../../sphinx/doc/usage/configuration.rst:4060 msgid "" "A list of prefixes that are ignored for sorting the Python module index " "(e.g., if this is set to :code-py:`['foo.']`, then ``foo.bar`` is shown " @@ -4171,36 +4176,36 @@ msgid "" "consists of a single package." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4064 +#: ../../sphinx/doc/usage/configuration.rst:4067 msgid "Works only for the HTML builder currently." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4072 +#: ../../sphinx/doc/usage/configuration.rst:4075 msgid "" "This value controls how :py:data:`~typing.Literal` types are displayed." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4075 +#: ../../sphinx/doc/usage/configuration.rst:4078 msgid "Examples" msgstr "实际案例" -#: ../../sphinx/doc/usage/configuration.rst:4077 +#: ../../sphinx/doc/usage/configuration.rst:4080 msgid "The examples below use the following :rst:dir:`py:function` directive:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4083 +#: ../../sphinx/doc/usage/configuration.rst:4086 msgid "" "When :code-py:`False`, :py:data:`~typing.Literal` types display as per " "standard Python syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4090 +#: ../../sphinx/doc/usage/configuration.rst:4093 msgid "" "When :code-py:`True`, :py:data:`~typing.Literal` types display with a short," " :PEP:`604`-inspired syntax, i.e.:" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4113 +#: ../../sphinx/doc/usage/configuration.rst:4116 msgid "" "For the Python domain, the signature length depends on whether the type " "parameters or the list of arguments are being formatted. For the former, the" @@ -4208,23 +4213,23 @@ msgid "" "the signature length ignores the length of the type parameters list." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4119 +#: ../../sphinx/doc/usage/configuration.rst:4122 msgid "" "For instance, with :code-py:`python_maximum_signature_line_length = 20`, " "only the list of type parameters will be wrapped while the arguments list " "will be rendered on a single line" msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4133 +#: ../../sphinx/doc/usage/configuration.rst:4136 msgid "" "Suppress the module name of the python reference if it can be resolved." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4138 +#: ../../sphinx/doc/usage/configuration.rst:4141 msgid "This feature is experimental." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4144 +#: ../../sphinx/doc/usage/configuration.rst:4147 msgid "" "Remove doctest flags (comments looking like :code-py:`# doctest: FLAG, ...`)" " at the ends of lines and ```` markers for all code blocks " @@ -4232,21 +4237,21 @@ msgid "" ":mod:`~sphinx.ext.doctest` for more possibilities of including doctests." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4151 +#: ../../sphinx/doc/usage/configuration.rst:4154 msgid "Now also removes ````." msgstr "现在也删除了“”。" -#: ../../sphinx/doc/usage/configuration.rst:4156 +#: ../../sphinx/doc/usage/configuration.rst:4159 msgid "Extension options" msgstr "扩展程序选项" -#: ../../sphinx/doc/usage/configuration.rst:4158 +#: ../../sphinx/doc/usage/configuration.rst:4161 msgid "" "Extensions frequently have their own configuration options. Those for " "Sphinx's first-party extensions are documented in each :doc:`extension's " "page `." msgstr "" -#: ../../sphinx/doc/usage/configuration.rst:4164 +#: ../../sphinx/doc/usage/configuration.rst:4167 msgid "Example configuration file" msgstr "" diff --git a/locale/zh_CN/LC_MESSAGES/usage/extensions/autosectionlabel.po b/locale/zh_CN/LC_MESSAGES/usage/extensions/autosectionlabel.po index 888731f88b..b76aae75d1 100644 --- a/locale/zh_CN/LC_MESSAGES/usage/extensions/autosectionlabel.po +++ b/locale/zh_CN/LC_MESSAGES/usage/extensions/autosectionlabel.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.1.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-07-31 00:36+0000\n" +"POT-Creation-Date: 2024-10-11 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:58+0000\n" "Last-Translator: wendi cao <651645601@qq.com>, 2020\n" "Language-Team: Chinese (China) (https://app.transifex.com/sphinx-doc/teams/15434/zh_CN/)\n" @@ -23,15 +23,15 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:4 msgid "" -":mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its " +":mod:`sphinx.ext.autosectionlabel` -- Allow referencing sections by their " "title" -msgstr "：模式：`sphinx.ext.autosectionlabel`--允许引用节使用其标题" +msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:11 msgid "" -"This extension allows you to refer sections its title. This affects to the " -"reference role (:rst:role:`ref`)." -msgstr "此扩展允许您引用其标题部分。这会影响引用角色（：rst:角色：`ref`）。" +"By default, cross-references to sections use labels (see :rst:role:`ref`). " +"This extension allows you to instead refer to sections by their title." +msgstr "" #: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:14 msgid "For example::" @@ -51,7 +51,15 @@ msgstr "" msgid "Configuration" msgstr "配置" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:36 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Type" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:0 +msgid "Default" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:38 msgid "" "True to prefix each section label with the name of the document it is in, " "followed by a colon. For example, ``index:Introduction`` for a section " @@ -62,20 +70,19 @@ msgstr "" "如果为True，则在每个节标签前面加上它所在文档的名称，后跟冒号。例如``索引：简介``对于文档中出现的名为“简介”的部分``索引.rst``. " "当同一节标题出现在不同的文档中时，有助于避免歧义。" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:44 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:48 msgid "" "If set, autosectionlabel chooses the sections for labeling by its depth. For" " example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated " "only for top level sections, and deeper sections are not labeled. It " -"defaults to ``None`` (disabled)." +"defaults to ``None`` (i.e. all sections are labeled)." msgstr "" -"如果已设置，autosectionlabel将按深度选择要标记的节。例如，当将1设置为“autosectionlabel_maxdepth”时，仅为顶层节生成标签，而不为深层节生成标签。默认为“无”（已禁用）。" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:51 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:55 msgid "Debugging" msgstr "" -#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:53 +#: ../../sphinx/doc/usage/extensions/autosectionlabel.rst:57 msgid "" "The ``WARNING: undefined label`` indicates that your reference in " ":rst:role:`ref` is mis-spelled. Invoking :program:`sphinx-build` with " diff --git a/sphinx b/sphinx index 8351936994..2f1d775dfd 160000 --- a/sphinx +++ b/sphinx @@ -1 +1 @@ -Subproject commit 8351936994df62aadcc299af3c8106893b746a14 +Subproject commit 2f1d775dfda9e4f81dfff6cfbe9edf7731e32a97