diff --git a/locales/ar/LC_MESSAGES/changes/index.po b/locales/ar/LC_MESSAGES/changes/index.po index 1144f9d20a..ddfaf9ec8c 100644 --- a/locales/ar/LC_MESSAGES/changes/index.po +++ b/locales/ar/LC_MESSAGES/changes/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -213,65 +213,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -279,21 +292,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/ar/LC_MESSAGES/usage/domains/python.po b/locales/ar/LC_MESSAGES/usage/domains/python.po index 3a2997bf15..e1f1f1cbf0 100644 --- a/locales/ar/LC_MESSAGES/usage/domains/python.po +++ b/locales/ar/LC_MESSAGES/usage/domains/python.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n" "MIME-Version: 1.0\n" @@ -369,38 +369,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -408,7 +406,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -416,74 +414,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -491,24 +489,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -516,19 +514,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -536,7 +534,7 @@ msgstr "" msgid "Returns" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -548,49 +546,49 @@ msgstr "" msgid "Raises" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -598,54 +596,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -653,50 +658,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -704,13 +709,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -720,7 +725,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/ar/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/ar/LC_MESSAGES/usage/extensions/intersphinx.po index 4b8aa3e102..f0a489d2f3 100644 --- a/locales/ar/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/ar/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/ca_ES/LC_MESSAGES/changes/index.po b/locales/ca_ES/LC_MESSAGES/changes/index.po index dbb145790b..0efee89863 100644 --- a/locales/ca_ES/LC_MESSAGES/changes/index.po +++ b/locales/ca_ES/LC_MESSAGES/changes/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -213,65 +213,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -279,21 +292,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/ca_ES/LC_MESSAGES/usage/domains/python.po b/locales/ca_ES/LC_MESSAGES/usage/domains/python.po index 2db555ca72..fef410439f 100644 --- a/locales/ca_ES/LC_MESSAGES/usage/domains/python.po +++ b/locales/ca_ES/LC_MESSAGES/usage/domains/python.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Language-Team: Catalan (Spain) (https://app.transifex.com/sphinx-doc/teams/15434/ca_ES/)\n" "MIME-Version: 1.0\n" @@ -369,38 +369,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -408,7 +406,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -416,74 +414,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -491,24 +489,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -516,19 +514,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -536,7 +534,7 @@ msgstr "" msgid "Returns" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -548,49 +546,49 @@ msgstr "" msgid "Raises" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -598,54 +596,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -653,50 +658,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -704,13 +709,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -720,7 +725,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/ca_ES/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/ca_ES/LC_MESSAGES/usage/extensions/intersphinx.po index 0ef45dca73..ea631ea3c7 100644 --- a/locales/ca_ES/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/ca_ES/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Catalan (Spain) (https://app.transifex.com/sphinx-doc/teams/15434/ca_ES/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/de/LC_MESSAGES/changes/index.po b/locales/de/LC_MESSAGES/changes/index.po index 9a4dbb341c..1376d1cd9c 100644 --- a/locales/de/LC_MESSAGES/changes/index.po +++ b/locales/de/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -217,65 +217,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -283,21 +296,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/de/LC_MESSAGES/usage/domains/python.po b/locales/de/LC_MESSAGES/usage/domains/python.po index 76e6d0770e..0eb1f35d89 100644 --- a/locales/de/LC_MESSAGES/usage/domains/python.po +++ b/locales/de/LC_MESSAGES/usage/domains/python.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Georg Brandl , 2023\n" "Language-Team: German (https://app.transifex.com/sphinx-doc/teams/15434/de/)\n" @@ -373,38 +373,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -412,7 +410,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -420,74 +418,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -495,24 +493,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -520,19 +518,19 @@ msgstr "" msgid "Parameters" msgstr "Parameter" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -540,7 +538,7 @@ msgstr "" msgid "Returns" msgstr "Rückgabe" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -552,49 +550,49 @@ msgstr "Rückgabetyp" msgid "Raises" msgstr "Verursacht" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -602,54 +600,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -657,50 +662,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -708,13 +713,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -724,7 +729,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/de/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/de/LC_MESSAGES/usage/extensions/intersphinx.po index 9be4e51bb6..dc98b7e93d 100644 --- a/locales/de/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/de/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: German (https://app.transifex.com/sphinx-doc/teams/15434/de/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/es/LC_MESSAGES/changes/index.po b/locales/es/LC_MESSAGES/changes/index.po index 620574e80e..9bfb116e97 100644 --- a/locales/es/LC_MESSAGES/changes/index.po +++ b/locales/es/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -217,65 +217,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -283,21 +296,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/es/LC_MESSAGES/usage/domains/python.po b/locales/es/LC_MESSAGES/usage/domains/python.po index 2addf6ac0d..8b372ad39e 100644 --- a/locales/es/LC_MESSAGES/usage/domains/python.po +++ b/locales/es/LC_MESSAGES/usage/domains/python.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Georg Brandl , 2023\n" "Language-Team: Spanish (https://app.transifex.com/sphinx-doc/teams/15434/es/)\n" @@ -373,38 +373,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -412,7 +410,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -420,74 +418,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -495,24 +493,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -520,19 +518,19 @@ msgstr "" msgid "Parameters" msgstr "Parámetros" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -540,7 +538,7 @@ msgstr "" msgid "Returns" msgstr "Devuelve" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -552,49 +550,49 @@ msgstr "Tipo del valor devuelto" msgid "Raises" msgstr "Muestra" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -602,54 +600,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -657,50 +662,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -708,13 +713,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -724,7 +729,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/es/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/es/LC_MESSAGES/usage/extensions/intersphinx.po index 29aa22746f..5cd882527c 100644 --- a/locales/es/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/es/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Spanish (https://app.transifex.com/sphinx-doc/teams/15434/es/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/fr/LC_MESSAGES/changes/index.po b/locales/fr/LC_MESSAGES/changes/index.po index 1afa3f0bb5..12287750fc 100644 --- a/locales/fr/LC_MESSAGES/changes/index.po +++ b/locales/fr/LC_MESSAGES/changes/index.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -219,65 +219,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "Bug corrigé" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -285,21 +298,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "En cours de test" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/fr/LC_MESSAGES/usage/domains/python.po b/locales/fr/LC_MESSAGES/usage/domains/python.po index 6546736cd7..71081cc8e7 100644 --- a/locales/fr/LC_MESSAGES/usage/domains/python.po +++ b/locales/fr/LC_MESSAGES/usage/domains/python.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Jérémie Tarot , 2024\n" "Language-Team: French (https://app.transifex.com/sphinx-doc/teams/15434/fr/)\n" @@ -374,38 +374,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -413,7 +411,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -421,74 +419,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -496,24 +494,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -521,19 +519,19 @@ msgstr "" msgid "Parameters" msgstr "Paramètres" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -541,7 +539,7 @@ msgstr "" msgid "Returns" msgstr "Renvoie" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -553,49 +551,49 @@ msgstr "Type renvoyé" msgid "Raises" msgstr "Lève" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -603,54 +601,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -658,50 +663,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -709,13 +714,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -725,7 +730,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/fr/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/fr/LC_MESSAGES/usage/extensions/intersphinx.po index 3d57c77a79..767152e4b9 100644 --- a/locales/fr/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/fr/LC_MESSAGES/usage/extensions/intersphinx.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: French (https://app.transifex.com/sphinx-doc/teams/15434/fr/)\n" @@ -234,53 +234,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -291,21 +309,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -314,42 +332,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "Afficher tous les liens d'un fichier de mappage Intersphinx" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -358,15 +376,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/it_IT/LC_MESSAGES/changes/index.po b/locales/it_IT/LC_MESSAGES/changes/index.po index cef9463093..b2db7ce940 100644 --- a/locales/it_IT/LC_MESSAGES/changes/index.po +++ b/locales/it_IT/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -217,65 +217,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -283,21 +296,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/it_IT/LC_MESSAGES/usage/domains/python.po b/locales/it_IT/LC_MESSAGES/usage/domains/python.po index 016afdfb22..62527ceb4a 100644 --- a/locales/it_IT/LC_MESSAGES/usage/domains/python.po +++ b/locales/it_IT/LC_MESSAGES/usage/domains/python.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Language-Team: Italian (Italy) (https://app.transifex.com/sphinx-doc/teams/15434/it_IT/)\n" "MIME-Version: 1.0\n" @@ -369,38 +369,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -408,7 +406,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -416,74 +414,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -491,24 +489,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -516,19 +514,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -536,7 +534,7 @@ msgstr "" msgid "Returns" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -548,49 +546,49 @@ msgstr "" msgid "Raises" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -598,54 +596,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -653,50 +658,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -704,13 +709,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -720,7 +725,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/it_IT/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/it_IT/LC_MESSAGES/usage/extensions/intersphinx.po index 8e2daa1a02..4c93b4f307 100644 --- a/locales/it_IT/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/it_IT/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Italian (Italy) (https://app.transifex.com/sphinx-doc/teams/15434/it_IT/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/ja/LC_MESSAGES/changes/index.po b/locales/ja/LC_MESSAGES/changes/index.po index 94ee0e24f8..da58063892 100644 --- a/locales/ja/LC_MESSAGES/changes/index.po +++ b/locales/ja/LC_MESSAGES/changes/index.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -219,65 +219,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "バグ修正" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -285,21 +298,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/ja/LC_MESSAGES/usage/domains/python.po b/locales/ja/LC_MESSAGES/usage/domains/python.po index 4983426212..d04f699072 100644 --- a/locales/ja/LC_MESSAGES/usage/domains/python.po +++ b/locales/ja/LC_MESSAGES/usage/domains/python.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Naofumi SAKAGUCHI , 2024\n" "Language-Team: Japanese (https://app.transifex.com/sphinx-doc/teams/15434/ja/)\n" @@ -386,39 +386,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "(``.. py:decorator:: removename(func)`` とは対象的です)" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -"これらに対応する、 ``py:deco`` といったロールはありません。代わりに、 :rst:role:`py:func` ロールを使用してください。" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr ":rst:dir:`py:decorator` とほぼ同じですが、対象がメソッドになります。" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." -msgstr "このデコレータを指定したい場合には、 :rst:role:`py:meth` ロールを使います。" +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." +msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "Pythonシグニチャ" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -426,7 +423,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -434,42 +431,42 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "詳細情報フィールドのリスト" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." @@ -477,11 +474,11 @@ msgstr "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "引数の説明です。" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "``type``: 引数の型です。可能ならリンクを生成します。" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." @@ -489,23 +486,23 @@ msgstr "" "``raises``, ``raise``, ``except``, ``exception``: " "この中から投げられる例外(いつ投げられるか？)を定義します" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "``var``, ``ivar``, ``cvar``: 変数の説明をします" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "``vartype``: 変数の型です。可能ならリンクを生成します。" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "``returns``, ``return``: 返り値の値について説明をします" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "``rtype``: 返り値の型です。可能ならリンクを生成します。" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -513,13 +510,13 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" @@ -528,11 +525,11 @@ msgstr "" "フィールドは、 ``return``, ``rtype`` 以外の場合は、上記のキーワードのうち、どれかと、引数を一つが引数として設定されています。 " "``return``, ``rtype`` だけは引数を取りません。サンプルを見ていただくのが一番でしょう::" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "これは次のようにレンダリングされます:" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "Send a message to a recipient" @@ -540,19 +537,19 @@ msgstr "Send a message to a recipient" msgid "Parameters" msgstr "パラメータ" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "The person sending the message" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "The recipient of the message" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "The body of the message" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "The priority of the message, can be a number 1-5" @@ -560,7 +557,7 @@ msgstr "The priority of the message, can be a number 1-5" msgid "Returns" msgstr "戻り値" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "the message id" @@ -572,49 +569,49 @@ msgstr "戻り値の型" msgid "Raises" msgstr "例外" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "if the message_body exceeds 160 characters" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "if the message_body is not a basestring" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "型情報が一語で表せる場合には、属性の型と説明をひとつにまとめることもできます::" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "Pythonオブジェクトのクロススリファンレス" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "以下のロールを使用すると、モジュール内のオブジェクトを参照できます。一致する識別子が見つかれば、ハイパーリンクが作成されます:" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "モジュールへの参照です。ドットで区切られた名前も使用できます。これはパッケージ名としても利用可能です。" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -625,21 +622,28 @@ msgstr "" ":confval:`add_function_parentheses` 設定値を ``True`` " "(デフォルト)にしておくと、Sphinxが自動で括弧を追加します。" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "モジュール変数を参照します。" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "「定義済み」定数です。変更して欲しくないPythonの変数にも使えます。" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "クラス名です。ドットで区切られた名前も使用できます。" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" @@ -647,33 +651,33 @@ msgid "" msgstr "" "オブジェクトのメソッドへの参照です。ロールのテキストには型名とメソッド名を含めなければなりません。ただし、型の記述中に書く場合には省略もできます。ドットで区切られた名前も使用できます。" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "オブジェクトの属性への参照です。" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "例外への参照です。ドットで区切られた名前も使用できます。" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "型が指定されていないオブジェクトの名前です。 :confval:`default_role` 一緒に使用すると便利です。" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -681,50 +685,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -732,13 +736,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "属性名が、現在のクラスのものかどうかを決定するのにも、同様の名前検索の仕組みが使用されます。" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -748,7 +752,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/ja/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/ja/LC_MESSAGES/usage/extensions/intersphinx.po index 6795519b5e..eb014413c1 100644 --- a/locales/ja/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/ja/LC_MESSAGES/usage/extensions/intersphinx.po @@ -13,7 +13,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Last-Translator: Tetsuo Koyama , 2020\n" "Language-Team: Japanese (https://app.transifex.com/sphinx-doc/teams/15434/ja/)\n" @@ -214,53 +214,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -271,21 +289,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -294,42 +312,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "Sphinx間のマッピングファイルにあるすべてのリンクを表示する" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -338,15 +356,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "基本認可のinventoryファイルでのIntersphinxの使用" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "Intersphinx は、次のような基本認可をサポートしています。" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/ko/LC_MESSAGES/changes/index.po b/locales/ko/LC_MESSAGES/changes/index.po index 9f69ceb90a..9b76d503c6 100644 --- a/locales/ko/LC_MESSAGES/changes/index.po +++ b/locales/ko/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -217,65 +217,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -283,21 +296,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/ko/LC_MESSAGES/usage/domains/python.po b/locales/ko/LC_MESSAGES/usage/domains/python.po index a9d2a58256..3c8033157b 100644 --- a/locales/ko/LC_MESSAGES/usage/domains/python.po +++ b/locales/ko/LC_MESSAGES/usage/domains/python.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Georg Brandl , 2023\n" "Language-Team: Korean (https://app.transifex.com/sphinx-doc/teams/15434/ko/)\n" @@ -374,38 +374,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -413,7 +411,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -421,74 +419,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -496,24 +494,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -521,19 +519,19 @@ msgstr "" msgid "Parameters" msgstr "매개변수" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -541,7 +539,7 @@ msgstr "" msgid "Returns" msgstr "반환값" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -553,49 +551,49 @@ msgstr "반환 형식" msgid "Raises" msgstr "예외" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -603,54 +601,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -658,50 +663,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -709,13 +714,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -725,7 +730,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/ko/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/ko/LC_MESSAGES/usage/extensions/intersphinx.po index d4ee934aa3..c8d798a276 100644 --- a/locales/ko/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/ko/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Korean (https://app.transifex.com/sphinx-doc/teams/15434/ko/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/pl_PL/LC_MESSAGES/changes/index.po b/locales/pl_PL/LC_MESSAGES/changes/index.po index 0783e8f2cb..cd96ed2a45 100644 --- a/locales/pl_PL/LC_MESSAGES/changes/index.po +++ b/locales/pl_PL/LC_MESSAGES/changes/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -213,65 +213,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -279,21 +292,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/pl_PL/LC_MESSAGES/usage/domains/python.po b/locales/pl_PL/LC_MESSAGES/usage/domains/python.po index 892a7f6f5c..4ab0ecb7b9 100644 --- a/locales/pl_PL/LC_MESSAGES/usage/domains/python.po +++ b/locales/pl_PL/LC_MESSAGES/usage/domains/python.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Language-Team: Polish (Poland) (https://app.transifex.com/sphinx-doc/teams/15434/pl_PL/)\n" "MIME-Version: 1.0\n" @@ -369,38 +369,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -408,7 +406,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -416,74 +414,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -491,24 +489,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -516,19 +514,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -536,7 +534,7 @@ msgstr "" msgid "Returns" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -548,49 +546,49 @@ msgstr "" msgid "Raises" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -598,54 +596,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -653,50 +658,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -704,13 +709,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -720,7 +725,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/pl_PL/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/pl_PL/LC_MESSAGES/usage/extensions/intersphinx.po index ce29438485..b00a93ad46 100644 --- a/locales/pl_PL/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/pl_PL/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Polish (Poland) (https://app.transifex.com/sphinx-doc/teams/15434/pl_PL/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/pot/.doctrees/authors.doctree b/locales/pot/.doctrees/authors.doctree index c7d2bab165..f1bdac1d5d 100644 Binary files a/locales/pot/.doctrees/authors.doctree and b/locales/pot/.doctrees/authors.doctree differ diff --git a/locales/pot/.doctrees/changes/0.1.doctree b/locales/pot/.doctrees/changes/0.1.doctree index d5a5cdabf0..f2e6b1c6c0 100644 Binary files a/locales/pot/.doctrees/changes/0.1.doctree and b/locales/pot/.doctrees/changes/0.1.doctree differ diff --git a/locales/pot/.doctrees/changes/0.2.doctree b/locales/pot/.doctrees/changes/0.2.doctree index 02b5b723f0..2cfcb36dfb 100644 Binary files a/locales/pot/.doctrees/changes/0.2.doctree and b/locales/pot/.doctrees/changes/0.2.doctree differ diff --git a/locales/pot/.doctrees/changes/0.3.doctree b/locales/pot/.doctrees/changes/0.3.doctree index 5c40c8823b..548c5a535b 100644 Binary files a/locales/pot/.doctrees/changes/0.3.doctree and b/locales/pot/.doctrees/changes/0.3.doctree differ diff --git a/locales/pot/.doctrees/changes/0.4.doctree b/locales/pot/.doctrees/changes/0.4.doctree index 6ad67f1b79..9fae9b5a3e 100644 Binary files a/locales/pot/.doctrees/changes/0.4.doctree and b/locales/pot/.doctrees/changes/0.4.doctree differ diff --git a/locales/pot/.doctrees/changes/0.5.doctree b/locales/pot/.doctrees/changes/0.5.doctree index da92c34103..dd00f13f58 100644 Binary files a/locales/pot/.doctrees/changes/0.5.doctree and b/locales/pot/.doctrees/changes/0.5.doctree differ diff --git a/locales/pot/.doctrees/changes/0.6.doctree b/locales/pot/.doctrees/changes/0.6.doctree index 3608840f48..16b488aae6 100644 Binary files a/locales/pot/.doctrees/changes/0.6.doctree and b/locales/pot/.doctrees/changes/0.6.doctree differ diff --git a/locales/pot/.doctrees/changes/1.0.doctree b/locales/pot/.doctrees/changes/1.0.doctree index ae573dc018..756f2c94af 100644 Binary files a/locales/pot/.doctrees/changes/1.0.doctree and b/locales/pot/.doctrees/changes/1.0.doctree differ diff --git a/locales/pot/.doctrees/changes/1.1.doctree b/locales/pot/.doctrees/changes/1.1.doctree index c7bb6e46fc..8ff499a0f4 100644 Binary files a/locales/pot/.doctrees/changes/1.1.doctree and b/locales/pot/.doctrees/changes/1.1.doctree differ diff --git a/locales/pot/.doctrees/changes/1.2.doctree b/locales/pot/.doctrees/changes/1.2.doctree index de837d1ebe..7c61e705c0 100644 Binary files a/locales/pot/.doctrees/changes/1.2.doctree and b/locales/pot/.doctrees/changes/1.2.doctree differ diff --git a/locales/pot/.doctrees/changes/1.3.doctree b/locales/pot/.doctrees/changes/1.3.doctree index fc1bdab9e8..83ee2990f4 100644 Binary files a/locales/pot/.doctrees/changes/1.3.doctree and b/locales/pot/.doctrees/changes/1.3.doctree differ diff --git a/locales/pot/.doctrees/changes/1.4.doctree b/locales/pot/.doctrees/changes/1.4.doctree index 8ec862699b..08eb002548 100644 Binary files a/locales/pot/.doctrees/changes/1.4.doctree and b/locales/pot/.doctrees/changes/1.4.doctree differ diff --git a/locales/pot/.doctrees/changes/1.5.doctree b/locales/pot/.doctrees/changes/1.5.doctree index b978b454ba..741fc0d8f2 100644 Binary files a/locales/pot/.doctrees/changes/1.5.doctree and b/locales/pot/.doctrees/changes/1.5.doctree differ diff --git a/locales/pot/.doctrees/changes/1.6.doctree b/locales/pot/.doctrees/changes/1.6.doctree index 1ec0922015..71c52e2c67 100644 Binary files a/locales/pot/.doctrees/changes/1.6.doctree and b/locales/pot/.doctrees/changes/1.6.doctree differ diff --git a/locales/pot/.doctrees/changes/1.7.doctree b/locales/pot/.doctrees/changes/1.7.doctree index 55013a3226..885b8d54bd 100644 Binary files a/locales/pot/.doctrees/changes/1.7.doctree and b/locales/pot/.doctrees/changes/1.7.doctree differ diff --git a/locales/pot/.doctrees/changes/1.8.doctree b/locales/pot/.doctrees/changes/1.8.doctree index 228422f5fb..a68a77be61 100644 Binary files a/locales/pot/.doctrees/changes/1.8.doctree and b/locales/pot/.doctrees/changes/1.8.doctree differ diff --git a/locales/pot/.doctrees/changes/2.0.doctree b/locales/pot/.doctrees/changes/2.0.doctree index 92364efa97..9f6d8309a5 100644 Binary files a/locales/pot/.doctrees/changes/2.0.doctree and b/locales/pot/.doctrees/changes/2.0.doctree differ diff --git a/locales/pot/.doctrees/changes/2.1.doctree b/locales/pot/.doctrees/changes/2.1.doctree index 91bbd27f89..1cd32ecebf 100644 Binary files a/locales/pot/.doctrees/changes/2.1.doctree and b/locales/pot/.doctrees/changes/2.1.doctree differ diff --git a/locales/pot/.doctrees/changes/2.2.doctree b/locales/pot/.doctrees/changes/2.2.doctree index 174c6733a2..a806720719 100644 Binary files a/locales/pot/.doctrees/changes/2.2.doctree and b/locales/pot/.doctrees/changes/2.2.doctree differ diff --git a/locales/pot/.doctrees/changes/2.3.doctree b/locales/pot/.doctrees/changes/2.3.doctree index b85e0c45f4..3745e0a8da 100644 Binary files a/locales/pot/.doctrees/changes/2.3.doctree and b/locales/pot/.doctrees/changes/2.3.doctree differ diff --git a/locales/pot/.doctrees/changes/2.4.doctree b/locales/pot/.doctrees/changes/2.4.doctree index df57dfc716..4fca8f17c8 100644 Binary files a/locales/pot/.doctrees/changes/2.4.doctree and b/locales/pot/.doctrees/changes/2.4.doctree differ diff --git a/locales/pot/.doctrees/changes/3.0.doctree b/locales/pot/.doctrees/changes/3.0.doctree index cfa156de02..cbe1decd93 100644 Binary files a/locales/pot/.doctrees/changes/3.0.doctree and b/locales/pot/.doctrees/changes/3.0.doctree differ diff --git a/locales/pot/.doctrees/changes/3.1.doctree b/locales/pot/.doctrees/changes/3.1.doctree index e5bb52f156..b6fee85336 100644 Binary files a/locales/pot/.doctrees/changes/3.1.doctree and b/locales/pot/.doctrees/changes/3.1.doctree differ diff --git a/locales/pot/.doctrees/changes/3.2.doctree b/locales/pot/.doctrees/changes/3.2.doctree index b40af7f6e9..1aaa644097 100644 Binary files a/locales/pot/.doctrees/changes/3.2.doctree and b/locales/pot/.doctrees/changes/3.2.doctree differ diff --git a/locales/pot/.doctrees/changes/3.3.doctree b/locales/pot/.doctrees/changes/3.3.doctree index ccb22de9c9..73a3b8aeea 100644 Binary files a/locales/pot/.doctrees/changes/3.3.doctree and b/locales/pot/.doctrees/changes/3.3.doctree differ diff --git a/locales/pot/.doctrees/changes/3.4.doctree b/locales/pot/.doctrees/changes/3.4.doctree index 4b53b155bb..eb40ef8808 100644 Binary files a/locales/pot/.doctrees/changes/3.4.doctree and b/locales/pot/.doctrees/changes/3.4.doctree differ diff --git a/locales/pot/.doctrees/changes/3.5.doctree b/locales/pot/.doctrees/changes/3.5.doctree index 6582ce2506..c8fe44e54f 100644 Binary files a/locales/pot/.doctrees/changes/3.5.doctree and b/locales/pot/.doctrees/changes/3.5.doctree differ diff --git a/locales/pot/.doctrees/changes/4.0.doctree b/locales/pot/.doctrees/changes/4.0.doctree index 0785728e2c..348318085e 100644 Binary files a/locales/pot/.doctrees/changes/4.0.doctree and b/locales/pot/.doctrees/changes/4.0.doctree differ diff --git a/locales/pot/.doctrees/changes/4.1.doctree b/locales/pot/.doctrees/changes/4.1.doctree index f14b647715..1369cd8587 100644 Binary files a/locales/pot/.doctrees/changes/4.1.doctree and b/locales/pot/.doctrees/changes/4.1.doctree differ diff --git a/locales/pot/.doctrees/changes/4.2.doctree b/locales/pot/.doctrees/changes/4.2.doctree index 467a87a430..cb9eca0f6b 100644 Binary files a/locales/pot/.doctrees/changes/4.2.doctree and b/locales/pot/.doctrees/changes/4.2.doctree differ diff --git a/locales/pot/.doctrees/changes/4.3.doctree b/locales/pot/.doctrees/changes/4.3.doctree index d12acb2572..c832570b1f 100644 Binary files a/locales/pot/.doctrees/changes/4.3.doctree and b/locales/pot/.doctrees/changes/4.3.doctree differ diff --git a/locales/pot/.doctrees/changes/4.4.doctree b/locales/pot/.doctrees/changes/4.4.doctree index 9409c7342f..363a2ce798 100644 Binary files a/locales/pot/.doctrees/changes/4.4.doctree and b/locales/pot/.doctrees/changes/4.4.doctree differ diff --git a/locales/pot/.doctrees/changes/4.5.doctree b/locales/pot/.doctrees/changes/4.5.doctree index 854cd66e7b..aab980bbbb 100644 Binary files a/locales/pot/.doctrees/changes/4.5.doctree and b/locales/pot/.doctrees/changes/4.5.doctree differ diff --git a/locales/pot/.doctrees/changes/5.0.doctree b/locales/pot/.doctrees/changes/5.0.doctree index e4e11658d2..61939d35a2 100644 Binary files a/locales/pot/.doctrees/changes/5.0.doctree and b/locales/pot/.doctrees/changes/5.0.doctree differ diff --git a/locales/pot/.doctrees/changes/5.1.doctree b/locales/pot/.doctrees/changes/5.1.doctree index 4b12e6fb98..5bbfdef34b 100644 Binary files a/locales/pot/.doctrees/changes/5.1.doctree and b/locales/pot/.doctrees/changes/5.1.doctree differ diff --git a/locales/pot/.doctrees/changes/5.2.doctree b/locales/pot/.doctrees/changes/5.2.doctree index 75ee4c9c0e..ed6e06f02d 100644 Binary files a/locales/pot/.doctrees/changes/5.2.doctree and b/locales/pot/.doctrees/changes/5.2.doctree differ diff --git a/locales/pot/.doctrees/changes/5.3.doctree b/locales/pot/.doctrees/changes/5.3.doctree index 254b257b95..94b76153be 100644 Binary files a/locales/pot/.doctrees/changes/5.3.doctree and b/locales/pot/.doctrees/changes/5.3.doctree differ diff --git a/locales/pot/.doctrees/changes/6.0.doctree b/locales/pot/.doctrees/changes/6.0.doctree index 5f9676fadb..737560b910 100644 Binary files a/locales/pot/.doctrees/changes/6.0.doctree and b/locales/pot/.doctrees/changes/6.0.doctree differ diff --git a/locales/pot/.doctrees/changes/6.1.doctree b/locales/pot/.doctrees/changes/6.1.doctree index a9abcb26fb..49c0c953f2 100644 Binary files a/locales/pot/.doctrees/changes/6.1.doctree and b/locales/pot/.doctrees/changes/6.1.doctree differ diff --git a/locales/pot/.doctrees/changes/6.2.doctree b/locales/pot/.doctrees/changes/6.2.doctree index 65653d2359..47116a91c8 100644 Binary files a/locales/pot/.doctrees/changes/6.2.doctree and b/locales/pot/.doctrees/changes/6.2.doctree differ diff --git a/locales/pot/.doctrees/changes/7.0.doctree b/locales/pot/.doctrees/changes/7.0.doctree index f612262381..2fa8077b94 100644 Binary files a/locales/pot/.doctrees/changes/7.0.doctree and b/locales/pot/.doctrees/changes/7.0.doctree differ diff --git a/locales/pot/.doctrees/changes/7.1.doctree b/locales/pot/.doctrees/changes/7.1.doctree index 6c0d0032fa..cb44668cc9 100644 Binary files a/locales/pot/.doctrees/changes/7.1.doctree and b/locales/pot/.doctrees/changes/7.1.doctree differ diff --git a/locales/pot/.doctrees/changes/7.2.doctree b/locales/pot/.doctrees/changes/7.2.doctree index a1e3b4937d..e6fa39aa55 100644 Binary files a/locales/pot/.doctrees/changes/7.2.doctree and b/locales/pot/.doctrees/changes/7.2.doctree differ diff --git a/locales/pot/.doctrees/changes/7.3.doctree b/locales/pot/.doctrees/changes/7.3.doctree index f8115c0d25..59f66b222f 100644 Binary files a/locales/pot/.doctrees/changes/7.3.doctree and b/locales/pot/.doctrees/changes/7.3.doctree differ diff --git a/locales/pot/.doctrees/changes/7.4.doctree b/locales/pot/.doctrees/changes/7.4.doctree index 4c575fd11a..1aec90db7d 100644 Binary files a/locales/pot/.doctrees/changes/7.4.doctree and b/locales/pot/.doctrees/changes/7.4.doctree differ diff --git a/locales/pot/.doctrees/changes/8.0.doctree b/locales/pot/.doctrees/changes/8.0.doctree index 3e1fcfff08..709d6ad7c6 100644 Binary files a/locales/pot/.doctrees/changes/8.0.doctree and b/locales/pot/.doctrees/changes/8.0.doctree differ diff --git a/locales/pot/.doctrees/changes/8.1.doctree b/locales/pot/.doctrees/changes/8.1.doctree index 207b465520..7f52e2411f 100644 Binary files a/locales/pot/.doctrees/changes/8.1.doctree and b/locales/pot/.doctrees/changes/8.1.doctree differ diff --git a/locales/pot/.doctrees/changes/index.doctree b/locales/pot/.doctrees/changes/index.doctree index e0d62c2484..8a5271d8b1 100644 Binary files a/locales/pot/.doctrees/changes/index.doctree and b/locales/pot/.doctrees/changes/index.doctree differ diff --git a/locales/pot/.doctrees/development/howtos/builders.doctree b/locales/pot/.doctrees/development/howtos/builders.doctree index 9371221ace..19d64901a0 100644 Binary files a/locales/pot/.doctrees/development/howtos/builders.doctree and b/locales/pot/.doctrees/development/howtos/builders.doctree differ diff --git a/locales/pot/.doctrees/development/howtos/index.doctree b/locales/pot/.doctrees/development/howtos/index.doctree index 2100e3eaac..703dfe2023 100644 Binary files a/locales/pot/.doctrees/development/howtos/index.doctree and b/locales/pot/.doctrees/development/howtos/index.doctree differ diff --git a/locales/pot/.doctrees/development/howtos/setup_extension.doctree b/locales/pot/.doctrees/development/howtos/setup_extension.doctree index 19afe1c151..934cbefdd7 100644 Binary files a/locales/pot/.doctrees/development/howtos/setup_extension.doctree and b/locales/pot/.doctrees/development/howtos/setup_extension.doctree differ diff --git a/locales/pot/.doctrees/development/html_themes/index.doctree b/locales/pot/.doctrees/development/html_themes/index.doctree index e7d0094403..448a4d1f05 100644 Binary files a/locales/pot/.doctrees/development/html_themes/index.doctree and b/locales/pot/.doctrees/development/html_themes/index.doctree differ diff --git a/locales/pot/.doctrees/development/html_themes/templating.doctree b/locales/pot/.doctrees/development/html_themes/templating.doctree index 89944c445c..bc85c890f7 100644 Binary files a/locales/pot/.doctrees/development/html_themes/templating.doctree and b/locales/pot/.doctrees/development/html_themes/templating.doctree differ diff --git a/locales/pot/.doctrees/development/index.doctree b/locales/pot/.doctrees/development/index.doctree index d98fe2f10f..af81b73e6f 100644 Binary files a/locales/pot/.doctrees/development/index.doctree and b/locales/pot/.doctrees/development/index.doctree differ diff --git a/locales/pot/.doctrees/development/tutorials/adding_domain.doctree b/locales/pot/.doctrees/development/tutorials/adding_domain.doctree index e80e3f2803..f1c0a5282d 100644 Binary files a/locales/pot/.doctrees/development/tutorials/adding_domain.doctree and b/locales/pot/.doctrees/development/tutorials/adding_domain.doctree differ diff --git a/locales/pot/.doctrees/development/tutorials/autodoc_ext.doctree b/locales/pot/.doctrees/development/tutorials/autodoc_ext.doctree index 422d078fe8..870c61ec6a 100644 Binary files a/locales/pot/.doctrees/development/tutorials/autodoc_ext.doctree and b/locales/pot/.doctrees/development/tutorials/autodoc_ext.doctree differ diff --git a/locales/pot/.doctrees/development/tutorials/examples/README.doctree b/locales/pot/.doctrees/development/tutorials/examples/README.doctree index 2fc6fc9727..dc0414dac0 100644 Binary files a/locales/pot/.doctrees/development/tutorials/examples/README.doctree and b/locales/pot/.doctrees/development/tutorials/examples/README.doctree differ diff --git a/locales/pot/.doctrees/development/tutorials/extending_build.doctree b/locales/pot/.doctrees/development/tutorials/extending_build.doctree index e85119dd89..f93ae1e329 100644 Binary files a/locales/pot/.doctrees/development/tutorials/extending_build.doctree and b/locales/pot/.doctrees/development/tutorials/extending_build.doctree differ diff --git a/locales/pot/.doctrees/development/tutorials/extending_syntax.doctree b/locales/pot/.doctrees/development/tutorials/extending_syntax.doctree index e543e7121c..1b7e6d48a6 100644 Binary files a/locales/pot/.doctrees/development/tutorials/extending_syntax.doctree and b/locales/pot/.doctrees/development/tutorials/extending_syntax.doctree differ diff --git a/locales/pot/.doctrees/development/tutorials/index.doctree b/locales/pot/.doctrees/development/tutorials/index.doctree index 299e6ecfd9..d8aa330cf9 100644 Binary files a/locales/pot/.doctrees/development/tutorials/index.doctree and b/locales/pot/.doctrees/development/tutorials/index.doctree differ diff --git a/locales/pot/.doctrees/environment.pickle b/locales/pot/.doctrees/environment.pickle index 364e5da4be..03473cca88 100644 Binary files a/locales/pot/.doctrees/environment.pickle and b/locales/pot/.doctrees/environment.pickle differ diff --git a/locales/pot/.doctrees/examples.doctree b/locales/pot/.doctrees/examples.doctree index cfbaa7f465..c68c54b4a2 100644 Binary files a/locales/pot/.doctrees/examples.doctree and b/locales/pot/.doctrees/examples.doctree differ diff --git a/locales/pot/.doctrees/extdev/appapi.doctree b/locales/pot/.doctrees/extdev/appapi.doctree index 7400c72526..dcde45f06f 100644 Binary files a/locales/pot/.doctrees/extdev/appapi.doctree and b/locales/pot/.doctrees/extdev/appapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/builderapi.doctree b/locales/pot/.doctrees/extdev/builderapi.doctree index 235f574662..4c57f3b7b7 100644 Binary files a/locales/pot/.doctrees/extdev/builderapi.doctree and b/locales/pot/.doctrees/extdev/builderapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/collectorapi.doctree b/locales/pot/.doctrees/extdev/collectorapi.doctree index e626a77927..2b89b030bd 100644 Binary files a/locales/pot/.doctrees/extdev/collectorapi.doctree and b/locales/pot/.doctrees/extdev/collectorapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/deprecated.doctree b/locales/pot/.doctrees/extdev/deprecated.doctree index 152a411452..854b51adc5 100644 Binary files a/locales/pot/.doctrees/extdev/deprecated.doctree and b/locales/pot/.doctrees/extdev/deprecated.doctree differ diff --git a/locales/pot/.doctrees/extdev/domainapi.doctree b/locales/pot/.doctrees/extdev/domainapi.doctree index 85a3733776..f949532e6d 100644 Binary files a/locales/pot/.doctrees/extdev/domainapi.doctree and b/locales/pot/.doctrees/extdev/domainapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/envapi.doctree b/locales/pot/.doctrees/extdev/envapi.doctree index 7441c70b21..7f27b3f39a 100644 Binary files a/locales/pot/.doctrees/extdev/envapi.doctree and b/locales/pot/.doctrees/extdev/envapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/event_callbacks.doctree b/locales/pot/.doctrees/extdev/event_callbacks.doctree index a67a0879df..659b8729a8 100644 Binary files a/locales/pot/.doctrees/extdev/event_callbacks.doctree and b/locales/pot/.doctrees/extdev/event_callbacks.doctree differ diff --git a/locales/pot/.doctrees/extdev/i18n.doctree b/locales/pot/.doctrees/extdev/i18n.doctree index c167bfdc0b..1257132024 100644 Binary files a/locales/pot/.doctrees/extdev/i18n.doctree and b/locales/pot/.doctrees/extdev/i18n.doctree differ diff --git a/locales/pot/.doctrees/extdev/index.doctree b/locales/pot/.doctrees/extdev/index.doctree index d5669e177d..d62eea58d5 100644 Binary files a/locales/pot/.doctrees/extdev/index.doctree and b/locales/pot/.doctrees/extdev/index.doctree differ diff --git a/locales/pot/.doctrees/extdev/logging.doctree b/locales/pot/.doctrees/extdev/logging.doctree index a141c6525d..96de3a72fb 100644 Binary files a/locales/pot/.doctrees/extdev/logging.doctree and b/locales/pot/.doctrees/extdev/logging.doctree differ diff --git a/locales/pot/.doctrees/extdev/markupapi.doctree b/locales/pot/.doctrees/extdev/markupapi.doctree index f486c811e0..b4b20b5bdd 100644 Binary files a/locales/pot/.doctrees/extdev/markupapi.doctree and b/locales/pot/.doctrees/extdev/markupapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/nodes.doctree b/locales/pot/.doctrees/extdev/nodes.doctree index c1f98d6a00..267ef398c6 100644 Binary files a/locales/pot/.doctrees/extdev/nodes.doctree and b/locales/pot/.doctrees/extdev/nodes.doctree differ diff --git a/locales/pot/.doctrees/extdev/parserapi.doctree b/locales/pot/.doctrees/extdev/parserapi.doctree index 5d6e72536b..ccc17e78d1 100644 Binary files a/locales/pot/.doctrees/extdev/parserapi.doctree and b/locales/pot/.doctrees/extdev/parserapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/projectapi.doctree b/locales/pot/.doctrees/extdev/projectapi.doctree index 4ee48394a5..e132f56f5e 100644 Binary files a/locales/pot/.doctrees/extdev/projectapi.doctree and b/locales/pot/.doctrees/extdev/projectapi.doctree differ diff --git a/locales/pot/.doctrees/extdev/testing.doctree b/locales/pot/.doctrees/extdev/testing.doctree index 02781e9bc5..e77aac0fcd 100644 Binary files a/locales/pot/.doctrees/extdev/testing.doctree and b/locales/pot/.doctrees/extdev/testing.doctree differ diff --git a/locales/pot/.doctrees/extdev/utils.doctree b/locales/pot/.doctrees/extdev/utils.doctree index 7ba8a99136..a47c7be1ba 100644 Binary files a/locales/pot/.doctrees/extdev/utils.doctree and b/locales/pot/.doctrees/extdev/utils.doctree differ diff --git a/locales/pot/.doctrees/faq.doctree b/locales/pot/.doctrees/faq.doctree index 98fc94ca83..062414905c 100644 Binary files a/locales/pot/.doctrees/faq.doctree and b/locales/pot/.doctrees/faq.doctree differ diff --git a/locales/pot/.doctrees/glossary.doctree b/locales/pot/.doctrees/glossary.doctree index 976dd7f7b2..a16c98cbe8 100644 Binary files a/locales/pot/.doctrees/glossary.doctree and b/locales/pot/.doctrees/glossary.doctree differ diff --git a/locales/pot/.doctrees/index.doctree b/locales/pot/.doctrees/index.doctree index cef36f924e..9b22767a93 100644 Binary files a/locales/pot/.doctrees/index.doctree and b/locales/pot/.doctrees/index.doctree differ diff --git a/locales/pot/.doctrees/internals/code-of-conduct.doctree b/locales/pot/.doctrees/internals/code-of-conduct.doctree index fe719cf4fe..2294d9ffcb 100644 Binary files a/locales/pot/.doctrees/internals/code-of-conduct.doctree and b/locales/pot/.doctrees/internals/code-of-conduct.doctree differ diff --git a/locales/pot/.doctrees/internals/contributing.doctree b/locales/pot/.doctrees/internals/contributing.doctree index 05fcc54bb3..dcc0162eb0 100644 Binary files a/locales/pot/.doctrees/internals/contributing.doctree and b/locales/pot/.doctrees/internals/contributing.doctree differ diff --git a/locales/pot/.doctrees/internals/index.doctree b/locales/pot/.doctrees/internals/index.doctree index 29dd03c83f..d1944be110 100644 Binary files a/locales/pot/.doctrees/internals/index.doctree and b/locales/pot/.doctrees/internals/index.doctree differ diff --git a/locales/pot/.doctrees/internals/organization.doctree b/locales/pot/.doctrees/internals/organization.doctree index 59bbd1f51d..67ad617dd2 100644 Binary files a/locales/pot/.doctrees/internals/organization.doctree and b/locales/pot/.doctrees/internals/organization.doctree differ diff --git a/locales/pot/.doctrees/internals/release-process.doctree b/locales/pot/.doctrees/internals/release-process.doctree index 667f8b34c7..77b47cb021 100644 Binary files a/locales/pot/.doctrees/internals/release-process.doctree and b/locales/pot/.doctrees/internals/release-process.doctree differ diff --git a/locales/pot/.doctrees/latex.doctree b/locales/pot/.doctrees/latex.doctree index 0846ee9124..e1e2c966d9 100644 Binary files a/locales/pot/.doctrees/latex.doctree and b/locales/pot/.doctrees/latex.doctree differ diff --git a/locales/pot/.doctrees/man/index.doctree b/locales/pot/.doctrees/man/index.doctree index ae2a44b231..ce7558ffbb 100644 Binary files a/locales/pot/.doctrees/man/index.doctree and b/locales/pot/.doctrees/man/index.doctree differ diff --git a/locales/pot/.doctrees/man/sphinx-apidoc.doctree b/locales/pot/.doctrees/man/sphinx-apidoc.doctree index f9fcc931f3..0e893957b8 100644 Binary files a/locales/pot/.doctrees/man/sphinx-apidoc.doctree and b/locales/pot/.doctrees/man/sphinx-apidoc.doctree differ diff --git a/locales/pot/.doctrees/man/sphinx-autogen.doctree b/locales/pot/.doctrees/man/sphinx-autogen.doctree index 3c24154603..0b03e4809f 100644 Binary files a/locales/pot/.doctrees/man/sphinx-autogen.doctree and b/locales/pot/.doctrees/man/sphinx-autogen.doctree differ diff --git a/locales/pot/.doctrees/man/sphinx-build.doctree b/locales/pot/.doctrees/man/sphinx-build.doctree index 1c0c7d8f2e..4b4f26e275 100644 Binary files a/locales/pot/.doctrees/man/sphinx-build.doctree and b/locales/pot/.doctrees/man/sphinx-build.doctree differ diff --git a/locales/pot/.doctrees/man/sphinx-quickstart.doctree b/locales/pot/.doctrees/man/sphinx-quickstart.doctree index 9cd380f7c6..d9d90219eb 100644 Binary files a/locales/pot/.doctrees/man/sphinx-quickstart.doctree and b/locales/pot/.doctrees/man/sphinx-quickstart.doctree differ diff --git a/locales/pot/.doctrees/support.doctree b/locales/pot/.doctrees/support.doctree index 6e8c16405c..230f9024b1 100644 Binary files a/locales/pot/.doctrees/support.doctree and b/locales/pot/.doctrees/support.doctree differ diff --git a/locales/pot/.doctrees/tutorial/automatic-doc-generation.doctree b/locales/pot/.doctrees/tutorial/automatic-doc-generation.doctree index 531834730c..bb8bc18895 100644 Binary files a/locales/pot/.doctrees/tutorial/automatic-doc-generation.doctree and b/locales/pot/.doctrees/tutorial/automatic-doc-generation.doctree differ diff --git a/locales/pot/.doctrees/tutorial/deploying.doctree b/locales/pot/.doctrees/tutorial/deploying.doctree index 3f499156c5..5d2478333b 100644 Binary files a/locales/pot/.doctrees/tutorial/deploying.doctree and b/locales/pot/.doctrees/tutorial/deploying.doctree differ diff --git a/locales/pot/.doctrees/tutorial/describing-code.doctree b/locales/pot/.doctrees/tutorial/describing-code.doctree index a988109697..033b6a99ad 100644 Binary files a/locales/pot/.doctrees/tutorial/describing-code.doctree and b/locales/pot/.doctrees/tutorial/describing-code.doctree differ diff --git a/locales/pot/.doctrees/tutorial/end.doctree b/locales/pot/.doctrees/tutorial/end.doctree index 7ccbc0a6f2..7c0585fd56 100644 Binary files a/locales/pot/.doctrees/tutorial/end.doctree and b/locales/pot/.doctrees/tutorial/end.doctree differ diff --git a/locales/pot/.doctrees/tutorial/first-steps.doctree b/locales/pot/.doctrees/tutorial/first-steps.doctree index ea4aeda786..71a567bb25 100644 Binary files a/locales/pot/.doctrees/tutorial/first-steps.doctree and b/locales/pot/.doctrees/tutorial/first-steps.doctree differ diff --git a/locales/pot/.doctrees/tutorial/getting-started.doctree b/locales/pot/.doctrees/tutorial/getting-started.doctree index 566894e04e..92b66b6b97 100644 Binary files a/locales/pot/.doctrees/tutorial/getting-started.doctree and b/locales/pot/.doctrees/tutorial/getting-started.doctree differ diff --git a/locales/pot/.doctrees/tutorial/index.doctree b/locales/pot/.doctrees/tutorial/index.doctree index 268aa7dd8d..791b97be36 100644 Binary files a/locales/pot/.doctrees/tutorial/index.doctree and b/locales/pot/.doctrees/tutorial/index.doctree differ diff --git a/locales/pot/.doctrees/tutorial/more-sphinx-customization.doctree b/locales/pot/.doctrees/tutorial/more-sphinx-customization.doctree index cbf286a7b8..68af991925 100644 Binary files a/locales/pot/.doctrees/tutorial/more-sphinx-customization.doctree and b/locales/pot/.doctrees/tutorial/more-sphinx-customization.doctree differ diff --git a/locales/pot/.doctrees/tutorial/narrative-documentation.doctree b/locales/pot/.doctrees/tutorial/narrative-documentation.doctree index 29d21cc14a..9a682d0707 100644 Binary files a/locales/pot/.doctrees/tutorial/narrative-documentation.doctree and b/locales/pot/.doctrees/tutorial/narrative-documentation.doctree differ diff --git a/locales/pot/.doctrees/usage/advanced/intl.doctree b/locales/pot/.doctrees/usage/advanced/intl.doctree index d47b2df462..2f0aabd2a0 100644 Binary files a/locales/pot/.doctrees/usage/advanced/intl.doctree and b/locales/pot/.doctrees/usage/advanced/intl.doctree differ diff --git a/locales/pot/.doctrees/usage/advanced/websupport/api.doctree b/locales/pot/.doctrees/usage/advanced/websupport/api.doctree index 3732720e5e..e4233a850b 100644 Binary files a/locales/pot/.doctrees/usage/advanced/websupport/api.doctree and b/locales/pot/.doctrees/usage/advanced/websupport/api.doctree differ diff --git a/locales/pot/.doctrees/usage/advanced/websupport/index.doctree b/locales/pot/.doctrees/usage/advanced/websupport/index.doctree index 57fd1c5296..9011a6ed1d 100644 Binary files a/locales/pot/.doctrees/usage/advanced/websupport/index.doctree and b/locales/pot/.doctrees/usage/advanced/websupport/index.doctree differ diff --git a/locales/pot/.doctrees/usage/advanced/websupport/quickstart.doctree b/locales/pot/.doctrees/usage/advanced/websupport/quickstart.doctree index 7e3d7c2886..844db9f4ac 100644 Binary files a/locales/pot/.doctrees/usage/advanced/websupport/quickstart.doctree and b/locales/pot/.doctrees/usage/advanced/websupport/quickstart.doctree differ diff --git a/locales/pot/.doctrees/usage/advanced/websupport/searchadapters.doctree b/locales/pot/.doctrees/usage/advanced/websupport/searchadapters.doctree index 9be5a0f4d9..b0a7a2d6b1 100644 Binary files a/locales/pot/.doctrees/usage/advanced/websupport/searchadapters.doctree and b/locales/pot/.doctrees/usage/advanced/websupport/searchadapters.doctree differ diff --git a/locales/pot/.doctrees/usage/advanced/websupport/storagebackends.doctree b/locales/pot/.doctrees/usage/advanced/websupport/storagebackends.doctree index 616009712a..11d3b87f46 100644 Binary files a/locales/pot/.doctrees/usage/advanced/websupport/storagebackends.doctree and b/locales/pot/.doctrees/usage/advanced/websupport/storagebackends.doctree differ diff --git a/locales/pot/.doctrees/usage/builders/index.doctree b/locales/pot/.doctrees/usage/builders/index.doctree index 0bb45e9a46..646e0fcd94 100644 Binary files a/locales/pot/.doctrees/usage/builders/index.doctree and b/locales/pot/.doctrees/usage/builders/index.doctree differ diff --git a/locales/pot/.doctrees/usage/configuration.doctree b/locales/pot/.doctrees/usage/configuration.doctree index 5e05606f70..6352c76ddd 100644 Binary files a/locales/pot/.doctrees/usage/configuration.doctree and b/locales/pot/.doctrees/usage/configuration.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/c.doctree b/locales/pot/.doctrees/usage/domains/c.doctree index c2eec487d5..5b6d3d5bfd 100644 Binary files a/locales/pot/.doctrees/usage/domains/c.doctree and b/locales/pot/.doctrees/usage/domains/c.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/cpp.doctree b/locales/pot/.doctrees/usage/domains/cpp.doctree index 3950a6b855..d95f8c4591 100644 Binary files a/locales/pot/.doctrees/usage/domains/cpp.doctree and b/locales/pot/.doctrees/usage/domains/cpp.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/index.doctree b/locales/pot/.doctrees/usage/domains/index.doctree index 42f0f95c3a..47daf19c03 100644 Binary files a/locales/pot/.doctrees/usage/domains/index.doctree and b/locales/pot/.doctrees/usage/domains/index.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/javascript.doctree b/locales/pot/.doctrees/usage/domains/javascript.doctree index 07301c4452..f62eabdff8 100644 Binary files a/locales/pot/.doctrees/usage/domains/javascript.doctree and b/locales/pot/.doctrees/usage/domains/javascript.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/mathematics.doctree b/locales/pot/.doctrees/usage/domains/mathematics.doctree index 6f8f17b289..bce062050f 100644 Binary files a/locales/pot/.doctrees/usage/domains/mathematics.doctree and b/locales/pot/.doctrees/usage/domains/mathematics.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/python.doctree b/locales/pot/.doctrees/usage/domains/python.doctree index 9f0de2ab24..03a3c5a835 100644 Binary files a/locales/pot/.doctrees/usage/domains/python.doctree and b/locales/pot/.doctrees/usage/domains/python.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/restructuredtext.doctree b/locales/pot/.doctrees/usage/domains/restructuredtext.doctree index 5f4adb63e5..e5287c5910 100644 Binary files a/locales/pot/.doctrees/usage/domains/restructuredtext.doctree and b/locales/pot/.doctrees/usage/domains/restructuredtext.doctree differ diff --git a/locales/pot/.doctrees/usage/domains/standard.doctree b/locales/pot/.doctrees/usage/domains/standard.doctree index 16cb7c2008..65fc1c8e2e 100644 Binary files a/locales/pot/.doctrees/usage/domains/standard.doctree and b/locales/pot/.doctrees/usage/domains/standard.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/autodoc.doctree b/locales/pot/.doctrees/usage/extensions/autodoc.doctree index 2b26ff14cf..8ea18aac5e 100644 Binary files a/locales/pot/.doctrees/usage/extensions/autodoc.doctree and b/locales/pot/.doctrees/usage/extensions/autodoc.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/autosectionlabel.doctree b/locales/pot/.doctrees/usage/extensions/autosectionlabel.doctree index 554f019698..e080d05ec8 100644 Binary files a/locales/pot/.doctrees/usage/extensions/autosectionlabel.doctree and b/locales/pot/.doctrees/usage/extensions/autosectionlabel.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/autosummary.doctree b/locales/pot/.doctrees/usage/extensions/autosummary.doctree index a3e80e212e..6f340c1bbd 100644 Binary files a/locales/pot/.doctrees/usage/extensions/autosummary.doctree and b/locales/pot/.doctrees/usage/extensions/autosummary.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/coverage.doctree b/locales/pot/.doctrees/usage/extensions/coverage.doctree index e6444cf23c..91a0624aa1 100644 Binary files a/locales/pot/.doctrees/usage/extensions/coverage.doctree and b/locales/pot/.doctrees/usage/extensions/coverage.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/doctest.doctree b/locales/pot/.doctrees/usage/extensions/doctest.doctree index bf451476e7..6973f18582 100644 Binary files a/locales/pot/.doctrees/usage/extensions/doctest.doctree and b/locales/pot/.doctrees/usage/extensions/doctest.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/duration.doctree b/locales/pot/.doctrees/usage/extensions/duration.doctree index 39c415c825..651626b96e 100644 Binary files a/locales/pot/.doctrees/usage/extensions/duration.doctree and b/locales/pot/.doctrees/usage/extensions/duration.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/example_google.doctree b/locales/pot/.doctrees/usage/extensions/example_google.doctree index e54c53feb3..7abb7abe02 100644 Binary files a/locales/pot/.doctrees/usage/extensions/example_google.doctree and b/locales/pot/.doctrees/usage/extensions/example_google.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/example_numpy.doctree b/locales/pot/.doctrees/usage/extensions/example_numpy.doctree index b36669117b..376cce7047 100644 Binary files a/locales/pot/.doctrees/usage/extensions/example_numpy.doctree and b/locales/pot/.doctrees/usage/extensions/example_numpy.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/extlinks.doctree b/locales/pot/.doctrees/usage/extensions/extlinks.doctree index f52ea1158d..2fa26d962f 100644 Binary files a/locales/pot/.doctrees/usage/extensions/extlinks.doctree and b/locales/pot/.doctrees/usage/extensions/extlinks.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/githubpages.doctree b/locales/pot/.doctrees/usage/extensions/githubpages.doctree index 1c8ae9d81e..0607673116 100644 Binary files a/locales/pot/.doctrees/usage/extensions/githubpages.doctree and b/locales/pot/.doctrees/usage/extensions/githubpages.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/graphviz.doctree b/locales/pot/.doctrees/usage/extensions/graphviz.doctree index f4799d7cf2..75fa0114b8 100644 Binary files a/locales/pot/.doctrees/usage/extensions/graphviz.doctree and b/locales/pot/.doctrees/usage/extensions/graphviz.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/ifconfig.doctree b/locales/pot/.doctrees/usage/extensions/ifconfig.doctree index eb37e8e1da..9c56512fd6 100644 Binary files a/locales/pot/.doctrees/usage/extensions/ifconfig.doctree and b/locales/pot/.doctrees/usage/extensions/ifconfig.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/imgconverter.doctree b/locales/pot/.doctrees/usage/extensions/imgconverter.doctree index 9c255525ff..d416a20aef 100644 Binary files a/locales/pot/.doctrees/usage/extensions/imgconverter.doctree and b/locales/pot/.doctrees/usage/extensions/imgconverter.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/index.doctree b/locales/pot/.doctrees/usage/extensions/index.doctree index e1aecbdc36..eb4c537144 100644 Binary files a/locales/pot/.doctrees/usage/extensions/index.doctree and b/locales/pot/.doctrees/usage/extensions/index.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/inheritance.doctree b/locales/pot/.doctrees/usage/extensions/inheritance.doctree index 0e8dbc691e..5ccc85410e 100644 Binary files a/locales/pot/.doctrees/usage/extensions/inheritance.doctree and b/locales/pot/.doctrees/usage/extensions/inheritance.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/intersphinx.doctree b/locales/pot/.doctrees/usage/extensions/intersphinx.doctree index 08ca6f8c6c..4334709558 100644 Binary files a/locales/pot/.doctrees/usage/extensions/intersphinx.doctree and b/locales/pot/.doctrees/usage/extensions/intersphinx.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/linkcode.doctree b/locales/pot/.doctrees/usage/extensions/linkcode.doctree index 473f27fdfb..861d9058c5 100644 Binary files a/locales/pot/.doctrees/usage/extensions/linkcode.doctree and b/locales/pot/.doctrees/usage/extensions/linkcode.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/math.doctree b/locales/pot/.doctrees/usage/extensions/math.doctree index 80207fdccd..d3ba9da237 100644 Binary files a/locales/pot/.doctrees/usage/extensions/math.doctree and b/locales/pot/.doctrees/usage/extensions/math.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/napoleon.doctree b/locales/pot/.doctrees/usage/extensions/napoleon.doctree index 1e201a3dd7..1cd9470ab3 100644 Binary files a/locales/pot/.doctrees/usage/extensions/napoleon.doctree and b/locales/pot/.doctrees/usage/extensions/napoleon.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/todo.doctree b/locales/pot/.doctrees/usage/extensions/todo.doctree index ceac3ae618..a97cd8fc74 100644 Binary files a/locales/pot/.doctrees/usage/extensions/todo.doctree and b/locales/pot/.doctrees/usage/extensions/todo.doctree differ diff --git a/locales/pot/.doctrees/usage/extensions/viewcode.doctree b/locales/pot/.doctrees/usage/extensions/viewcode.doctree index ba3ec9032e..13d76fd510 100644 Binary files a/locales/pot/.doctrees/usage/extensions/viewcode.doctree and b/locales/pot/.doctrees/usage/extensions/viewcode.doctree differ diff --git a/locales/pot/.doctrees/usage/index.doctree b/locales/pot/.doctrees/usage/index.doctree index f76b471a18..fbab94854c 100644 Binary files a/locales/pot/.doctrees/usage/index.doctree and b/locales/pot/.doctrees/usage/index.doctree differ diff --git a/locales/pot/.doctrees/usage/installation.doctree b/locales/pot/.doctrees/usage/installation.doctree index 6321dbbccc..098dd302a8 100644 Binary files a/locales/pot/.doctrees/usage/installation.doctree and b/locales/pot/.doctrees/usage/installation.doctree differ diff --git a/locales/pot/.doctrees/usage/markdown.doctree b/locales/pot/.doctrees/usage/markdown.doctree index ca9da4893c..fa3994adcd 100644 Binary files a/locales/pot/.doctrees/usage/markdown.doctree and b/locales/pot/.doctrees/usage/markdown.doctree differ diff --git a/locales/pot/.doctrees/usage/quickstart.doctree b/locales/pot/.doctrees/usage/quickstart.doctree index 8b3dfa3e61..746ba69c62 100644 Binary files a/locales/pot/.doctrees/usage/quickstart.doctree and b/locales/pot/.doctrees/usage/quickstart.doctree differ diff --git a/locales/pot/.doctrees/usage/referencing.doctree b/locales/pot/.doctrees/usage/referencing.doctree index 0072944c8a..6015ecf670 100644 Binary files a/locales/pot/.doctrees/usage/referencing.doctree and b/locales/pot/.doctrees/usage/referencing.doctree differ diff --git a/locales/pot/.doctrees/usage/restructuredtext/basics.doctree b/locales/pot/.doctrees/usage/restructuredtext/basics.doctree index c53b5e8a95..a9b9193919 100644 Binary files a/locales/pot/.doctrees/usage/restructuredtext/basics.doctree and b/locales/pot/.doctrees/usage/restructuredtext/basics.doctree differ diff --git a/locales/pot/.doctrees/usage/restructuredtext/directives.doctree b/locales/pot/.doctrees/usage/restructuredtext/directives.doctree index 5b98c6274e..ed8ec1ee1d 100644 Binary files a/locales/pot/.doctrees/usage/restructuredtext/directives.doctree and b/locales/pot/.doctrees/usage/restructuredtext/directives.doctree differ diff --git a/locales/pot/.doctrees/usage/restructuredtext/domains.doctree b/locales/pot/.doctrees/usage/restructuredtext/domains.doctree index 8b7ade2e78..c502c1eb89 100644 Binary files a/locales/pot/.doctrees/usage/restructuredtext/domains.doctree and b/locales/pot/.doctrees/usage/restructuredtext/domains.doctree differ diff --git a/locales/pot/.doctrees/usage/restructuredtext/field-lists.doctree b/locales/pot/.doctrees/usage/restructuredtext/field-lists.doctree index 3526be6659..793c178f49 100644 Binary files a/locales/pot/.doctrees/usage/restructuredtext/field-lists.doctree and b/locales/pot/.doctrees/usage/restructuredtext/field-lists.doctree differ diff --git a/locales/pot/.doctrees/usage/restructuredtext/index.doctree b/locales/pot/.doctrees/usage/restructuredtext/index.doctree index 885cb27363..72eaff0fe1 100644 Binary files a/locales/pot/.doctrees/usage/restructuredtext/index.doctree and b/locales/pot/.doctrees/usage/restructuredtext/index.doctree differ diff --git a/locales/pot/.doctrees/usage/restructuredtext/roles.doctree b/locales/pot/.doctrees/usage/restructuredtext/roles.doctree index 50cb279e70..273cbd8858 100644 Binary files a/locales/pot/.doctrees/usage/restructuredtext/roles.doctree and b/locales/pot/.doctrees/usage/restructuredtext/roles.doctree differ diff --git a/locales/pot/.doctrees/usage/theming.doctree b/locales/pot/.doctrees/usage/theming.doctree index 187b70975d..ce9c2a9da0 100644 Binary files a/locales/pot/.doctrees/usage/theming.doctree and b/locales/pot/.doctrees/usage/theming.doctree differ diff --git a/locales/pot/usage/extensions/intersphinx.pot b/locales/pot/usage/extensions/intersphinx.pot index c5514a5ed7..04940c8385 100644 --- a/locales/pot/usage/extensions/intersphinx.pot +++ b/locales/pot/usage/extensions/intersphinx.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -121,97 +121,105 @@ msgid "For a set of books edited and tested locally and then published together, msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 +msgid "If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's resolution mechanism to resolve all references to the current project, rather than an external reference. This is useful when documentation is shared between projects, with the 'upstream' or 'parent' project using intersphinx-style references in its documentation. For example, a project such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "Projects re-using *Astropy*'s documentation or inheriting their docstrings would then configure their :confval:`!intersphinx_mapping` with an :code-py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 msgid "The maximum number of days to cache remote inventories. Set this to a negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "timeout is not a time limit on the entire response download; rather, an exception is raised if the server has not issued a response for *timeout* seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "the name of a specific reference type in a domain, e.g., ``std:doc``, ``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or ``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "When a non-:rst:role:`external` cross-reference is being resolved by intersphinx, skip resolution if it matches one of the specifications in this list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-reference ``:doc:`installation``` will not be attempted to be resolved by intersphinx, but ``:external+otherbook:doc:`installation``` will be attempted to be resolved in the inventory named ``otherbook`` in :confval:`intersphinx_mapping`. At the same time, all cross-references generated in, e.g., Python, declarations will still be attempted to be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "If ``*`` is in the list of domains, then no non-:rst:role:`external` references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "Use Intersphinx to perform lookup only in external projects, and not the current project. Intersphinx still needs to know the type of object you would like to find, so the general form of this role is to write the cross-refererence as if the object is in the current project, but then prefix it with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "``:external:domain:reftype:`target```, e.g., ``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "If you would like to constrain the lookup to a specific external project, then the key of the project, as specified in :confval:`intersphinx_mapping`, is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "``:external+invname:domain:reftype:`target```, e.g., ``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "``:external+invname:reftype:`target```, e.g., ``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "To show all Intersphinx links and their targets of an Intersphinx mapping file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful when searching for the root cause of a broken Intersphinx link in a documentation project. The following example prints the Intersphinx mapping of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "The user and password will be stripped from the URL when generating the links." msgstr "" diff --git a/locales/pt_BR/LC_MESSAGES/changes/index.po b/locales/pt_BR/LC_MESSAGES/changes/index.po index 78182de3e4..9ba0f62eea 100644 --- a/locales/pt_BR/LC_MESSAGES/changes/index.po +++ b/locales/pt_BR/LC_MESSAGES/changes/index.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2024-07-31 00:36+0000\n" "Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Portuguese (Brazil) (https://app.transifex.com/sphinx-doc/teams/15434/pt_BR/)\n" @@ -220,17 +220,30 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "Erros corrigidos" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" @@ -238,7 +251,7 @@ msgstr "" "#13060: Pesquisa HTML: usa ``Map`` para armazenar pontuações de termos por " "arquivo. Patch de James Addison" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." @@ -247,13 +260,13 @@ msgstr "" "para entradas de índice em francês. Veja :confval:`latex_use_xindy`. Patch " "de Jean-François B." -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." @@ -261,31 +274,31 @@ msgstr "" "#13096: Pesquisa HTML: verifica se os termos de consulta existem como " "propriedades nos índices de termos antes de acessá-los." -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -293,21 +306,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "Testes" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/pt_BR/LC_MESSAGES/usage/domains/python.po b/locales/pt_BR/LC_MESSAGES/usage/domains/python.po index d73db7726a..9847b27e18 100644 --- a/locales/pt_BR/LC_MESSAGES/usage/domains/python.po +++ b/locales/pt_BR/LC_MESSAGES/usage/domains/python.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Portuguese (Brazil) (https://app.transifex.com/sphinx-doc/teams/15434/pt_BR/)\n" @@ -455,14 +455,10 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "(em oposição a ``.. py:decorator:: removename(func)``.)" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -"Não há papel ``py:deco`` para vincular a um decorador que está marcado com " -"esta diretiva; em vez disso, use o papel :rst:role:`py:func`." -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " @@ -472,7 +468,7 @@ msgstr "" "lógica, substituindo :confval:`python_maximum_signature_line_length` e " ":confval:`maximum_signature_line_length`." -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " @@ -482,20 +478,20 @@ msgstr "" "linha lógica, substituindo :confval:`python_maximum_signature_line_length` e" " :confval:`maximum_signature_line_length`." -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" "O mesmo que :rst:dir:`py:decorator`, mas para decoradores que são métodos." -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." -msgstr "Consulte um método decorador usando o papel :rst:role:`py:meth`." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." +msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "Assinaturas Python" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -503,7 +499,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -511,36 +507,36 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "Listas de campos de informações" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "campos meta adicionados." -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" @@ -549,7 +545,7 @@ msgstr "" "reStructuredText com esses campos são reconhecidas e formatadas de maneira " "adequada:" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." @@ -557,11 +553,11 @@ msgstr "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Descrição de um parâmetro." -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "``type``: Tipo de um parâmetro. Cria um link, se possível." -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." @@ -569,23 +565,23 @@ msgstr "" "``raises``, ``raise``, ``except``, ``exception``: Que (e quando) uma exceção" " específica é levantada." -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "``var``, ``ivar``, ``cvar``: Descrição de uma variável." -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "``vartype``: Tipo de uma variável. Cria um link, se possível." -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "``returns``, ``return``: Descrição do valor de retorno." -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "``rtype``: Tipo de retorno. Cria um link, se possível." -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -597,7 +593,7 @@ msgstr "" "indica que o objeto python é um membro privado. É usado em " ":py:mod:`sphinx.ext.autodoc` para filtrar membros." -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." @@ -605,7 +601,7 @@ msgstr "" "Na versão atual, todos ``var``, ``ivar`` e ``cvar`` são representados como " "\"Variável\". Não há diferença alguma." -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" @@ -615,11 +611,11 @@ msgstr "" "argumento (exceto para ``returns`` e ``rtype``, que não precisam de um " "argumento). Isso é melhor explicado por um exemplo::" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "Isso será renderizado como:" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "Envia uma mensagem para um destinatário" @@ -627,19 +623,19 @@ msgstr "Envia uma mensagem para um destinatário" msgid "Parameters" msgstr "Parâmetros" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "A pessoa enviando a mensagem" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "O destinatário da mensagem" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "O corpo da mensagem" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "A prioridade da mensagem, pode ser um número de 1-5" @@ -647,7 +643,7 @@ msgstr "A prioridade da mensagem, pode ser um número de 1-5" msgid "Returns" msgstr "Retorna" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "o id da mensagem" @@ -659,15 +655,15 @@ msgstr "Tipo de retorno" msgid "Raises" msgstr "Levanta" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "se message_body exceder 160 caracteres" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "se message_body não for uma basestring" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" @@ -675,7 +671,7 @@ msgstr "" "Também é possível combinar o tipo e descrição do parâmetro, se o tipo for " "uma única palavra, como isso::" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" @@ -683,17 +679,17 @@ msgstr "" "Tipos de contêineres tal como listas e dicionários podem ser vinculados " "automaticamente usando a seguinte sintaxe::" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "Referência cruzada de objetos Python" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" @@ -702,7 +698,7 @@ msgstr "" "possivelmente alvos de hiperlink se um identificador correspondente for " "encontrado:" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." @@ -710,7 +706,7 @@ msgstr "" "Referencia um módulo; um nome pontilhado pode ser usado. Isso também deve " "ser usado para nomes de pacotes." -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -722,11 +718,18 @@ msgstr "" " eles serão adicionados automaticamente pelo Sphinx se o valor da " "configuração :confval:`add_function_parentheses` for ``True`` (o padrão)." -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "Referencia uma variável a nível de módulo." -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." @@ -734,11 +737,11 @@ msgstr "" "Referencia uma constante \"definida\". Isso pode ser uma variável Python que" " não é destinada a ser alterada." -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "Referencia uma classe; um nome pontilhado pode ser usado." -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" @@ -748,23 +751,23 @@ msgstr "" "tipo e o nome do método; se ocorrer dentro da descrição de um tipo, o nome " "do tipo pode ser omitido. Um nome pontilhado pode ser usado." -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "Referencia um atributo de dados de um objeto." -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "O papel também é capaz de fazer referência à propriedade." -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "Referência um apelido de tipo" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "Referencia uma exceção. Um nome pontilhado pode ser usado." -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." @@ -772,11 +775,11 @@ msgstr "" "Referencia um objeto de tipo não especificado. Útil, por exemplo, como " ":confval:`default_role`." -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -784,50 +787,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -835,7 +838,7 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." @@ -843,7 +846,7 @@ msgstr "" "Uma heurística semelhante é usada para determinar se o nome é um atributo da" " classe documentada atualmente." -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -860,7 +863,7 @@ msgstr "" "Como isso pode ficar ambíguo, se houver mais de uma correspondência " "possível, você receberá um aviso do Sphinx." -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/pt_BR/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/pt_BR/LC_MESSAGES/usage/extensions/intersphinx.po index fbece458fb..46dd79d629 100644 --- a/locales/pt_BR/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/pt_BR/LC_MESSAGES/usage/extensions/intersphinx.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Portuguese (Brazil) (https://app.transifex.com/sphinx-doc/teams/15434/pt_BR/)\n" @@ -266,30 +266,48 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "Valor padrão alterado de uma lista vazia para ``['std:doc']``." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "Uma lista de strings sendo:" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," @@ -297,7 +315,7 @@ msgstr "" "o nome de um tipo de referência específica em um domínio, p. ex., " "``std:doc``, ``py:func`` ou ``cpp:class``," -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" @@ -305,11 +323,11 @@ msgstr "" "o nome de um domínio e um coringa, p. e.g., ``std:*``, ``py:*`` ou " "``cpp:*``, ou" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "simplesmente um coringa ``*``." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" @@ -319,7 +337,7 @@ msgstr "" "resolvida por interesphinxes, pule a resolução se ela corresponder a uma das" " especificações nesta lista." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -337,7 +355,7 @@ msgstr "" "cruzadas geradas em, por exemplo, declarações do Python, ainda serão " "tentadas para serem resolvidas por interesphinx." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." @@ -345,15 +363,15 @@ msgstr "" "Se ``*`` estiver na lista de domínios, nenhuma referência " "não-:rst:role:`external` será resolvida por intersphinx." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "Referenciar explicitamente objetos externos" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "A extensão Intersphinx fornece o seguinte papel." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -367,7 +385,7 @@ msgstr "" "referência cruzada como se o objeto estivesse no projeto atual, mas depois " "prefixe-o com ``:external`` . As duas formas são então" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" @@ -375,7 +393,7 @@ msgstr "" "``:external:domain:reftype:`alvo```, p. ex., " "``:external:py:class:`zipfile.ZipFile```, ou" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." @@ -384,7 +402,7 @@ msgstr "" "``:external:doc:`installation```. Com este atalho, o domínio é assumido como" " ``std``." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," @@ -394,7 +412,7 @@ msgstr "" "chave do projeto, conforme especificado em :confval:`intersphinx_mapping`, " "também é adicionada para obter os dois formulários" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" @@ -402,7 +420,7 @@ msgstr "" "``:external+invname:domain:reftype:`alvo```, p. ex., " "``:external+python:py:class:`zipfile.ZipFile``` ou" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." @@ -410,11 +428,11 @@ msgstr "" "``:external+invname:reftype:`alvo```, p. ex., " "``:external+python:doc:`installation```." -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "Mostrando todos os links de um arquivo de mapeamento Intersphinx" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -423,15 +441,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "Usando Intersphinx com arquivo de inventário sob autorização básica" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "Intersphinx oferece suporte a autorização básica assim::" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/ru/LC_MESSAGES/changes/index.po b/locales/ru/LC_MESSAGES/changes/index.po index 5057aa97d8..d105f6afbc 100644 --- a/locales/ru/LC_MESSAGES/changes/index.po +++ b/locales/ru/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -217,65 +217,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -283,21 +296,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/ru/LC_MESSAGES/usage/domains/python.po b/locales/ru/LC_MESSAGES/usage/domains/python.po index 14dffe6578..b4898611c5 100644 --- a/locales/ru/LC_MESSAGES/usage/domains/python.po +++ b/locales/ru/LC_MESSAGES/usage/domains/python.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: SeryiMysh , 2024\n" "Language-Team: Russian (https://app.transifex.com/sphinx-doc/teams/15434/ru/)\n" @@ -374,38 +374,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -413,7 +411,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -421,74 +419,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -496,24 +494,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -521,19 +519,19 @@ msgstr "" msgid "Parameters" msgstr "Параметры" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -541,7 +539,7 @@ msgstr "" msgid "Returns" msgstr "Результат" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -553,49 +551,49 @@ msgstr "Тип результата" msgid "Raises" msgstr "Исключение" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -603,54 +601,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -658,50 +663,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -709,13 +714,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -725,7 +730,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/ru/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/ru/LC_MESSAGES/usage/extensions/intersphinx.po index 4e24817711..3d0b9c298d 100644 --- a/locales/ru/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/ru/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Russian (https://app.transifex.com/sphinx-doc/teams/15434/ru/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/sr/LC_MESSAGES/changes/index.po b/locales/sr/LC_MESSAGES/changes/index.po index 168825cd4d..645a065e49 100644 --- a/locales/sr/LC_MESSAGES/changes/index.po +++ b/locales/sr/LC_MESSAGES/changes/index.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -217,65 +217,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -283,21 +296,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/sr/LC_MESSAGES/usage/domains/python.po b/locales/sr/LC_MESSAGES/usage/domains/python.po index e42293a081..bcbbfbac0b 100644 --- a/locales/sr/LC_MESSAGES/usage/domains/python.po +++ b/locales/sr/LC_MESSAGES/usage/domains/python.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Vladimir Milovanović , 2023\n" "Language-Team: Serbian (https://app.transifex.com/sphinx-doc/teams/15434/sr/)\n" @@ -373,38 +373,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -412,7 +410,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -420,74 +418,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -495,24 +493,24 @@ msgid "" ":py:mod:`sphinx.ext.autodoc` for filtering members." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "" @@ -520,19 +518,19 @@ msgstr "" msgid "Parameters" msgstr "Параметри" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "" @@ -540,7 +538,7 @@ msgstr "" msgid "Returns" msgstr "Резултат" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "" @@ -552,49 +550,49 @@ msgstr "Тип резултата" msgid "Raises" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -602,54 +600,61 @@ msgid "" "value is ``True`` (the default)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -657,50 +662,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -708,13 +713,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -724,7 +729,7 @@ msgid "" "possible match, you will get a warning from Sphinx." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/sr/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/sr/LC_MESSAGES/usage/extensions/intersphinx.po index 823025f8d6..f5ef8bf896 100644 --- a/locales/sr/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/sr/LC_MESSAGES/usage/extensions/intersphinx.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Language-Team: Serbian (https://app.transifex.com/sphinx-doc/teams/15434/sr/)\n" "MIME-Version: 1.0\n" @@ -192,53 +192,71 @@ msgstr "" #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -249,21 +267,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -272,42 +290,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -316,15 +334,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/locales/zh_CN/LC_MESSAGES/changes/index.po b/locales/zh_CN/LC_MESSAGES/changes/index.po index f299b50840..fddd273d7e 100644 --- a/locales/zh_CN/LC_MESSAGES/changes/index.po +++ b/locales/zh_CN/LC_MESSAGES/changes/index.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-03 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+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" @@ -218,65 +218,78 @@ msgid "" "error. Patch by Kevin Deldycke and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:103 +#: ../../sphinx/CHANGES.rst:101 +msgid "" +"#13105: Introduce the :rst:role:`py:deco` role to cross-reference decorator " +"functions and methods in the Python domain. Patch by Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:104 +msgid "" +"#9169: Add the :confval:`intersphinx_resolve_self` option to resolve an " +"intersphinx reference to the current project. Patch by Jakob Lykke Andersen " +"and Adam Turner." +msgstr "" + +#: ../../sphinx/CHANGES.rst:109 msgid "Bugs fixed" msgstr "Bug 修复" -#: ../../sphinx/CHANGES.rst:105 +#: ../../sphinx/CHANGES.rst:111 msgid "" "#12463: autosummary: Respect an empty module ``__all__``. Patch by Valentin " "Pratz" msgstr "" -#: ../../sphinx/CHANGES.rst:107 +#: ../../sphinx/CHANGES.rst:113 msgid "" "#13060: HTML Search: use ``Map`` to store per-file term scores. Patch by " "James Addison" msgstr "" -#: ../../sphinx/CHANGES.rst:109 +#: ../../sphinx/CHANGES.rst:115 msgid "" "#13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries " "in French. See :confval:`latex_use_xindy`. Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:112 +#: ../../sphinx/CHANGES.rst:118 msgid "" "#13152: LaTeX: fix a typo from v7.4.0 in a default for ``\\sphinxboxsetup``." " Patch by Jean-François B." msgstr "" -#: ../../sphinx/CHANGES.rst:114 +#: ../../sphinx/CHANGES.rst:120 msgid "" "#13096: HTML Search: check that query terms exist as properties in term " "indices before accessing them." msgstr "" -#: ../../sphinx/CHANGES.rst:116 +#: ../../sphinx/CHANGES.rst:122 msgid "" "#11233: linkcheck: match redirect URIs against :confval:`linkcheck_ignore` " "by overriding session-level ``requests.get_redirect_target``." msgstr "" -#: ../../sphinx/CHANGES.rst:118 +#: ../../sphinx/CHANGES.rst:124 msgid "" "#13195: viewcode: Fix issue where import paths differ from the directory " "structure. Patch by Ben Egan and Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:121 +#: ../../sphinx/CHANGES.rst:127 msgid "" "#13188: autodoc: fix detection of class methods implemented in C. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:123 +#: ../../sphinx/CHANGES.rst:129 msgid "" "#1810: Always copy static files when building, regardless of whether any " "documents have changed since the previous build. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:126 +#: ../../sphinx/CHANGES.rst:132 msgid "" "#13201: autodoc: fix ordering of members when using ``groupwise`` for " ":confval:`autodoc_member_order`. Class methods are now rendered before " @@ -284,21 +297,27 @@ msgid "" "attributes. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/CHANGES.rst:131 +#: ../../sphinx/CHANGES.rst:137 msgid "" "#12975: Avoid rendering a trailing comma in C and C++ multi-line signatures." msgstr "" -#: ../../sphinx/CHANGES.rst:132 +#: ../../sphinx/CHANGES.rst:138 msgid "" "#13178: autodoc: Fix resolution for ``pathlib`` types. Patch by Adam Turner." msgstr "" -#: ../../sphinx/CHANGES.rst:136 +#: ../../sphinx/CHANGES.rst:140 +msgid "" +"#13136: autodoc: Correctly handle multiple inheritance. Patch by Pavel " +"Holica" +msgstr "" + +#: ../../sphinx/CHANGES.rst:144 msgid "Testing" msgstr "测试" -#: ../../sphinx/CHANGES.rst:138 +#: ../../sphinx/CHANGES.rst:146 msgid "" "#13224: Correctness fixup for ``test_html_multi_line_copyright``. Patch by " "Colin Watson, applied by James Addison." diff --git a/locales/zh_CN/LC_MESSAGES/usage/domains/python.po b/locales/zh_CN/LC_MESSAGES/usage/domains/python.po index 3e30baeb42..82c838db84 100644 --- a/locales/zh_CN/LC_MESSAGES/usage/domains/python.po +++ b/locales/zh_CN/LC_MESSAGES/usage/domains/python.po @@ -14,7 +14,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-30 00:48+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2023-10-03 00:37+0000\n" "Last-Translator: Melia Lee , 2024\n" "Language-Team: Chinese (China) (https://app.transifex.com/sphinx-doc/teams/15434/zh_CN/)\n" @@ -383,38 +383,36 @@ msgid "(as opposed to ``.. py:decorator:: removename(func)``.)" msgstr "（而不是“.. py:装饰器:: removename(func)”。）" #: ../../sphinx/doc/usage/domains/python.rst:565 -msgid "" -"There is no ``py:deco`` role to link to a decorator that is marked up with " -"this directive; rather, use the :rst:role:`py:func` role." -msgstr "没有“py:deco”角色链接到用这个指令标记的装饰器；相反，使用:rst:role:`py:func` 角色。" +msgid "Refer to a decorator function using the :rst:role:`py:deco` role." +msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:571 +#: ../../sphinx/doc/usage/domains/python.rst:570 msgid "" "Ensures that the decorator's arguments will be emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:580 +#: ../../sphinx/doc/usage/domains/python.rst:579 msgid "" "Ensure that the decorator's type parameters are emitted on a single logical " "line, overriding :confval:`python_maximum_signature_line_length` and " ":confval:`maximum_signature_line_length`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:590 +#: ../../sphinx/doc/usage/domains/python.rst:589 msgid "Same as :rst:dir:`py:decorator`, but for decorators that are methods." msgstr "与 :rst:dir:`py:装饰器`相同，但对于作为方法的装饰器。" -#: ../../sphinx/doc/usage/domains/python.rst:592 -msgid "Refer to a decorator method using the :rst:role:`py:meth` role." -msgstr "使用 :rst:role:`py:meth` 角色引用装饰器方法。" +#: ../../sphinx/doc/usage/domains/python.rst:591 +msgid "Refer to a decorator method using the :rst:role:`py:deco` role." +msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:599 +#: ../../sphinx/doc/usage/domains/python.rst:598 msgid "Python Signatures" msgstr "Python签名" -#: ../../sphinx/doc/usage/domains/python.rst:601 +#: ../../sphinx/doc/usage/domains/python.rst:600 msgid "" "Signatures of functions, methods and class constructors can be given like " "they would be written in Python. This can include default values, " @@ -422,7 +420,7 @@ msgid "" "parameters. For example:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:614 +#: ../../sphinx/doc/usage/domains/python.rst:613 msgid "" "For functions with optional parameters that don't have default values " "(typically functions implemented in C extension modules without keyword " @@ -430,74 +428,74 @@ msgid "" " single directive:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:624 +#: ../../sphinx/doc/usage/domains/python.rst:623 msgid "" "Another approach is to use square brackets to specify the optional parts. " "When using square brackets, it is customary to place the opening bracket " "before the comma (``[,``)." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:631 +#: ../../sphinx/doc/usage/domains/python.rst:630 msgid "" "Python 3.12 introduced *type parameters*, which are type variables declared " "directly within the class or function definition:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:642 +#: ../../sphinx/doc/usage/domains/python.rst:641 msgid "The corresponding reStructuredText markup would be:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:652 +#: ../../sphinx/doc/usage/domains/python.rst:651 msgid ":pep:`695` and :pep:`696`, for details and the full specification." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:658 +#: ../../sphinx/doc/usage/domains/python.rst:657 msgid "Info field lists" msgstr "信息字段列表" -#: ../../sphinx/doc/usage/domains/python.rst:663 +#: ../../sphinx/doc/usage/domains/python.rst:662 msgid "meta fields are added." msgstr "元字段被添加。" -#: ../../sphinx/doc/usage/domains/python.rst:665 +#: ../../sphinx/doc/usage/domains/python.rst:664 msgid "" "Inside Python object description directives, reStructuredText field lists " "with these fields are recognized and formatted nicely:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:669 +#: ../../sphinx/doc/usage/domains/python.rst:668 msgid "" "``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: " "Description of a parameter." msgstr "“`param”，“parameter”，“arg”, “argument”，“key”，“keyword”：描述一个参数。" -#: ../../sphinx/doc/usage/domains/python.rst:671 +#: ../../sphinx/doc/usage/domains/python.rst:670 msgid "``type``: Type of a parameter. Creates a link if possible." msgstr "“type”：参数的类型。如果可能，创建一个链接。" -#: ../../sphinx/doc/usage/domains/python.rst:672 +#: ../../sphinx/doc/usage/domains/python.rst:671 msgid "" "``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific" " exception is raised." msgstr "“raises”，“raise”，“except”，“exception”：指（当）引一个特定的异常抛出。" -#: ../../sphinx/doc/usage/domains/python.rst:674 +#: ../../sphinx/doc/usage/domains/python.rst:673 msgid "``var``, ``ivar``, ``cvar``: Description of a variable." msgstr "\"var，“ivar”，“cvar”：变量的描述。" -#: ../../sphinx/doc/usage/domains/python.rst:675 +#: ../../sphinx/doc/usage/domains/python.rst:674 msgid "``vartype``: Type of a variable. Creates a link if possible." msgstr "“vartype”：变量类型。 如果可能，创建一个链接。" -#: ../../sphinx/doc/usage/domains/python.rst:676 +#: ../../sphinx/doc/usage/domains/python.rst:675 msgid "``returns``, ``return``: Description of the return value." msgstr "“returns”，“return”： 返回值的描述。" -#: ../../sphinx/doc/usage/domains/python.rst:677 +#: ../../sphinx/doc/usage/domains/python.rst:676 msgid "``rtype``: Return type. Creates a link if possible." msgstr "“rtype”：返回类型。 如果可能，创建一个链接。" -#: ../../sphinx/doc/usage/domains/python.rst:678 +#: ../../sphinx/doc/usage/domains/python.rst:677 msgid "" "``meta``: Add metadata to description of the python object. The metadata " "will not be shown on output document. For example, ``:meta private:`` " @@ -507,24 +505,24 @@ msgstr "" "\"meta”：python对象的描述中添加元数据。元数据不会显示在输出文档中。例如，“:meta private: " "”表示python对象是私有成员。它被用于:py:mod:sphinx.ext.autodoc`，筛选成员。" -#: ../../sphinx/doc/usage/domains/python.rst:685 +#: ../../sphinx/doc/usage/domains/python.rst:684 msgid "" "In current release, all ``var``, ``ivar`` and ``cvar`` are represented as " "\"Variable\". There is no difference at all." msgstr "在当前版本中，所有\"var，“ivar”，“cvar”都表示为 “Variable（变量）” 。完全没有区别。" -#: ../../sphinx/doc/usage/domains/python.rst:688 +#: ../../sphinx/doc/usage/domains/python.rst:687 msgid "" "The field names must consist of one of these keywords and an argument " "(except for ``returns`` and ``rtype``, which do not need an argument). This" " is best explained by an example::" msgstr "字段名称必须包含这些关键字之一和参数（除了“returns”和“rtype”，它们不需要参数）。这可以用一个例子来解释：" -#: ../../sphinx/doc/usage/domains/python.rst:706 +#: ../../sphinx/doc/usage/domains/python.rst:705 msgid "This will render like this:" msgstr "这将呈现如下：" -#: ../../sphinx/doc/usage/domains/python.rst:712 +#: ../../sphinx/doc/usage/domains/python.rst:711 msgid "Send a message to a recipient" msgstr "向收件人发送邮件" @@ -532,19 +530,19 @@ msgstr "向收件人发送邮件" msgid "Parameters" msgstr "参数" -#: ../../sphinx/doc/usage/domains/python.rst:714 +#: ../../sphinx/doc/usage/domains/python.rst:713 msgid "The person sending the message" msgstr "发送消息的人" -#: ../../sphinx/doc/usage/domains/python.rst:715 +#: ../../sphinx/doc/usage/domains/python.rst:714 msgid "The recipient of the message" msgstr "邮件的收件人" -#: ../../sphinx/doc/usage/domains/python.rst:716 +#: ../../sphinx/doc/usage/domains/python.rst:715 msgid "The body of the message" msgstr "消息的正文" -#: ../../sphinx/doc/usage/domains/python.rst:717 +#: ../../sphinx/doc/usage/domains/python.rst:716 msgid "The priority of the message, can be a number 1-5" msgstr "消息的优先级可以是1-5" @@ -552,7 +550,7 @@ msgstr "消息的优先级可以是1-5" msgid "Returns" msgstr "返回" -#: ../../sphinx/doc/usage/domains/python.rst:719 +#: ../../sphinx/doc/usage/domains/python.rst:718 msgid "the message id" msgstr "消息ID" @@ -564,49 +562,49 @@ msgstr "返回类型" msgid "Raises" msgstr "引发" -#: ../../sphinx/doc/usage/domains/python.rst:721 +#: ../../sphinx/doc/usage/domains/python.rst:720 msgid "if the message_body exceeds 160 characters" msgstr "如果信息主体超过160个字符" -#: ../../sphinx/doc/usage/domains/python.rst:722 +#: ../../sphinx/doc/usage/domains/python.rst:721 msgid "if the message_body is not a basestring" msgstr "如果信息主体不是基本字符串" -#: ../../sphinx/doc/usage/domains/python.rst:724 +#: ../../sphinx/doc/usage/domains/python.rst:723 msgid "" "It is also possible to combine parameter type and description, if the type " "is a single word, like this::" msgstr "如果类型是单个单词，也可以组合参数类型和描述，如下：" -#: ../../sphinx/doc/usage/domains/python.rst:731 +#: ../../sphinx/doc/usage/domains/python.rst:730 msgid "" "Container types such as lists and dictionaries can be linked automatically " "using the following syntax::" msgstr "可以使用以下语法自动链接容器类型，如列表和词典::" -#: ../../sphinx/doc/usage/domains/python.rst:741 +#: ../../sphinx/doc/usage/domains/python.rst:740 msgid "" "Multiple types in a type field will be linked automatically if separated by " "either the vertical bar (``|``) or the word \"or\"::" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:755 +#: ../../sphinx/doc/usage/domains/python.rst:754 msgid "Cross-referencing Python objects" msgstr "交叉引用Python对象" -#: ../../sphinx/doc/usage/domains/python.rst:757 +#: ../../sphinx/doc/usage/domains/python.rst:756 msgid "" "The following roles refer to objects in modules and are possibly hyperlinked" " if a matching identifier is found:" msgstr "以下角色引用模块中的对象，如果找到匹配的标识符，则可能是超链接：" -#: ../../sphinx/doc/usage/domains/python.rst:762 +#: ../../sphinx/doc/usage/domains/python.rst:761 msgid "" "Reference a module; a dotted name may be used. This should also be used for" " package names." msgstr "参考模块；可以使用虚线名称，这也应该用于包名称。" -#: ../../sphinx/doc/usage/domains/python.rst:767 +#: ../../sphinx/doc/usage/domains/python.rst:766 msgid "" "Reference a Python function; dotted names may be used. The role text needs " "not include trailing parentheses to enhance readability; they will be added " @@ -616,54 +614,61 @@ msgstr "" "引用Python函数；可以使用带虚线的名称。角色文本不需要包括尾随括号以增强可读性；如果:confval:`add_function_parentheses`" " 配置值为“ True” (默认值)，它们将由Sphinx自动添加。" -#: ../../sphinx/doc/usage/domains/python.rst:774 +#: ../../sphinx/doc/usage/domains/python.rst:773 +msgid "" +"Reference a Python decorator; dotted names may be used. The rendered output " +"will be prepended with an at-sign (``@``), for example: " +"``:py:deco:`removename``` produces :py:deco:`removename`." +msgstr "" + +#: ../../sphinx/doc/usage/domains/python.rst:784 msgid "Reference a module-level variable." msgstr "引用模块级变量。" -#: ../../sphinx/doc/usage/domains/python.rst:778 +#: ../../sphinx/doc/usage/domains/python.rst:788 msgid "" "Reference a \"defined\" constant. This may be a Python variable that is not" " intended to be changed." msgstr "引用一个“定义的”常量。这可能是一个不打算更改的 Python 变量。" -#: ../../sphinx/doc/usage/domains/python.rst:783 +#: ../../sphinx/doc/usage/domains/python.rst:793 msgid "Reference a class; a dotted name may be used." msgstr "引用一个类；可以使用虚线名称。" -#: ../../sphinx/doc/usage/domains/python.rst:787 +#: ../../sphinx/doc/usage/domains/python.rst:797 msgid "" "Reference a method of an object. The role text can include the type name " "and the method name; if it occurs within the description of a type, the type" " name can be omitted. A dotted name may be used." msgstr "引用对象的方法。角色文本可以包括类型名称和方法名称；如果它出现在类型的描述中，则可以省略类型名称。可以使用点状名称。" -#: ../../sphinx/doc/usage/domains/python.rst:793 +#: ../../sphinx/doc/usage/domains/python.rst:803 msgid "Reference a data attribute of an object." msgstr "引用对象的数据属性。" -#: ../../sphinx/doc/usage/domains/python.rst:795 +#: ../../sphinx/doc/usage/domains/python.rst:805 msgid "The role is also able to refer to property." msgstr "也可以指向属性。" -#: ../../sphinx/doc/usage/domains/python.rst:799 +#: ../../sphinx/doc/usage/domains/python.rst:809 msgid "Reference a type alias." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:803 +#: ../../sphinx/doc/usage/domains/python.rst:813 msgid "Reference an exception. A dotted name may be used." msgstr "引用一个例外。可以使用带虚线的名称。" -#: ../../sphinx/doc/usage/domains/python.rst:807 +#: ../../sphinx/doc/usage/domains/python.rst:817 msgid "" "Reference an object of unspecified type. Useful e.g. as the " ":confval:`default_role`." msgstr "引用未指定类型的对象。例如有用 :confval:`default_role`。" -#: ../../sphinx/doc/usage/domains/python.rst:814 +#: ../../sphinx/doc/usage/domains/python.rst:824 msgid "Target specification" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:816 +#: ../../sphinx/doc/usage/domains/python.rst:826 msgid "" "The target can be specified as a fully qualified name (e.g. " "``:py:meth:`my_module.MyClass.my_method```) or any shortened version (e.g. " @@ -671,50 +676,50 @@ msgid "" "resolution`_ for details on the resolution of shortened names." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:822 +#: ../../sphinx/doc/usage/domains/python.rst:832 msgid "" ":ref:`Cross-referencing modifiers ` can be applied. In " "short:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:825 +#: ../../sphinx/doc/usage/domains/python.rst:835 msgid "" "You may supply an explicit title and reference target: " "``:py:mod:`mathematical functions ``` will refer to the ``math`` " "module, but the link text will be \"mathematical functions\"." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:829 +#: ../../sphinx/doc/usage/domains/python.rst:839 msgid "" "If you prefix the content with an exclamation mark (``!``), no " "reference/hyperlink will be created." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:832 +#: ../../sphinx/doc/usage/domains/python.rst:842 msgid "" "If you prefix the content with ``~``, the link text will only be the last " "component of the target. For example, ``:py:meth:`~queue.Queue.get``` will " "refer to ``queue.Queue.get`` but only display ``get`` as the link text." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:839 +#: ../../sphinx/doc/usage/domains/python.rst:849 msgid "Target resolution" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:841 +#: ../../sphinx/doc/usage/domains/python.rst:851 msgid "" "A given link target name is resolved to an object using the following " "strategy:" msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:843 +#: ../../sphinx/doc/usage/domains/python.rst:853 msgid "" "Names in these roles are searched first without any further qualification, " "then with the current module name prepended, then with the current module " "and class name (if any) prepended." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:847 +#: ../../sphinx/doc/usage/domains/python.rst:857 msgid "" "If you prefix the name with a dot (``.``), this order is reversed. For " "example, in the documentation of Python's :py:mod:`codecs` module, " @@ -722,13 +727,13 @@ msgid "" "``:py:func:`.open``` refers to :func:`codecs.open`." msgstr "" -#: ../../sphinx/doc/usage/domains/python.rst:852 +#: ../../sphinx/doc/usage/domains/python.rst:862 msgid "" "A similar heuristic is used to determine whether the name is an attribute of" " the currently documented class." msgstr "类似的启发式方法用于确定名称是否是当前记录的类的属性。" -#: ../../sphinx/doc/usage/domains/python.rst:855 +#: ../../sphinx/doc/usage/domains/python.rst:865 msgid "" "Also, if the name is prefixed with a dot, and no exact match is found, the " "target is taken as a suffix and all object names with that suffix are " @@ -739,7 +744,7 @@ msgid "" msgstr "" "此外，如果名称以点为前缀，并且未找到完全匹配，则将目标作为后缀，并搜索具有该后缀的所有对象名称。例如，“:py:meth:`.TarFile.close`”引用“tarfile.TarFile.close()”函数，即使当前模块不是“tarfile”。由于这可能会变得模棱两可，如果有多个可能匹配，您将收到Sphinx的警告。" -#: ../../sphinx/doc/usage/domains/python.rst:862 +#: ../../sphinx/doc/usage/domains/python.rst:872 msgid "" "Note that you can combine the ``~`` and ``.`` prefixes: " "``:py:meth:`~.TarFile.close``` will reference the " diff --git a/locales/zh_CN/LC_MESSAGES/usage/extensions/intersphinx.po b/locales/zh_CN/LC_MESSAGES/usage/extensions/intersphinx.po index 0e0e663c09..56b15409ff 100644 --- a/locales/zh_CN/LC_MESSAGES/usage/extensions/intersphinx.po +++ b/locales/zh_CN/LC_MESSAGES/usage/extensions/intersphinx.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 8.2.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-27 00:50+0000\n" +"POT-Creation-Date: 2025-02-04 00:49+0000\n" "PO-Revision-Date: 2018-06-26 15:59+0000\n" "Last-Translator: Lu , 2022\n" "Language-Team: Chinese (China) (https://app.transifex.com/sphinx-doc/teams/15434/zh_CN/)\n" @@ -209,53 +209,71 @@ msgstr "对于一套在本地编辑和测试，然后一起出版的书，先试 #: ../../sphinx/doc/usage/extensions/intersphinx.rst:140 msgid "" +"If provided, :confval:`!intersphinx_resolve_self` overrides intersphinx's " +"resolution mechanism to resolve all references to the current project, " +"rather than an external reference. This is useful when documentation is " +"shared between projects, with the 'upstream' or 'parent' project using " +"intersphinx-style references in its documentation. For example, a project " +"such as *Astropy* might set:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:152 +msgid "" +"Projects re-using *Astropy*'s documentation or inheriting their docstrings " +"would then configure their :confval:`!intersphinx_mapping` with an :code-" +"py:`'astropy'` key, pointing to *astropy*'s :file:`objects.inv`. For " +"example:" +msgstr "" + +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +msgid "" "The maximum number of days to cache remote inventories. Set this to a " "negative value to cache inventories for unlimited time." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:147 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:174 msgid "The number of seconds for timeout. Use ``None`` for no timeout." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:151 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:178 msgid "" "timeout is not a time limit on the entire response download; rather, an " "exception is raised if the server has not issued a response for *timeout* " "seconds." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:163 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:190 msgid "Changed default value from an empty list to ``['std:doc']``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:165 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:192 msgid "A list of strings being either:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:167 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:194 msgid "" "the name of a specific reference type in a domain, e.g., ``std:doc``, " "``py:func``, or ``cpp:class``," msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:169 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:196 msgid "" "the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or " "``cpp:*``, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:171 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:198 msgid "simply a wildcard ``*``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:173 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:200 msgid "" "When a non-:rst:role:`external` cross-reference is being resolved by " "intersphinx, skip resolution if it matches one of the specifications in this" " list." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:177 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 msgid "" "For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-" "reference ``:doc:`installation``` will not be attempted to be resolved by " @@ -266,21 +284,21 @@ msgid "" "resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:185 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:212 msgid "" "If ``*`` is in the list of domains, then no non-:rst:role:`external` " "references will be resolved by intersphinx." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:189 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 msgid "Explicitly Reference External Objects" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:191 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:218 msgid "The Intersphinx extension provides the following role." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:197 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:224 msgid "" "Use Intersphinx to perform lookup only in external projects, and not the " "current project. Intersphinx still needs to know the type of object you " @@ -289,42 +307,42 @@ msgid "" "with ``:external``. The two forms are then" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:204 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:231 msgid "" "``:external:domain:reftype:`target```, e.g., " "``:external:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:206 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 msgid "" "``:external:reftype:`target```, e.g., ``:external:doc:`installation```. With" " this shorthand, the domain is assumed to be ``std``." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:210 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:237 msgid "" "If you would like to constrain the lookup to a specific external project, " "then the key of the project, as specified in :confval:`intersphinx_mapping`," " is added as well to get the two forms" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:214 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:241 msgid "" "``:external+invname:domain:reftype:`target```, e.g., " "``:external+python:py:class:`zipfile.ZipFile```, or" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:216 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:243 msgid "" "``:external+invname:reftype:`target```, e.g., " "``:external+python:doc:`installation```." msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:220 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:247 msgid "Showing all links of an Intersphinx mapping file" msgstr "显示内部sphinx映射文件的所有链接" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:222 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:249 msgid "" "To show all Intersphinx links and their targets of an Intersphinx mapping " "file, run ``python -m sphinx.ext.intersphinx url-or-path``. This is helpful" @@ -333,15 +351,15 @@ msgid "" "of the Python documentation:" msgstr "" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:233 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:260 msgid "Using Intersphinx with inventory file under Basic Authorization" msgstr "在基本授权下使用Intersphinx和库存文件" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:235 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:262 msgid "Intersphinx supports Basic Authorization like this::" msgstr "Intersphinx支持如下基本授权：" -#: ../../sphinx/doc/usage/extensions/intersphinx.rst:240 +#: ../../sphinx/doc/usage/extensions/intersphinx.rst:267 msgid "" "The user and password will be stripped from the URL when generating the " "links." diff --git a/sphinx b/sphinx index d486e801e2..758dc81303 160000 --- a/sphinx +++ b/sphinx @@ -1 +1 @@ -Subproject commit d486e801e22ada60a1266fb8404d865cdc057ec3 +Subproject commit 758dc8130366bb2d8ae36c50c86e497c25970d82