Skip to content

Commit

Permalink
Update translations by GHA https://github.com/sphinx-doc/sphinx-doc-t…
Browse files Browse the repository at this point in the history 
…ranslations/actions/runs/9786654061
  • Loading branch information
sphinx-auto-update committed Jul 4, 2024
1 parent 5fd12a9 commit 1644171
Show file tree
Hide file tree
Showing 73 changed files with 68,807 additions and 67,117 deletions.
9,424 changes: 4,720 additions & 4,704 deletions locale/ar/LC_MESSAGES/changes.po
View file

Large diffs are not rendered by default.

10 changes: 7 additions & 3 deletions locale/ar/LC_MESSAGES/extdev/builderapi.po
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx 7.4.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-06-24 06:45+0000\n"
"POT-Creation-Date: 2024-07-04 00:41+0000\n"
"PO-Revision-Date: 2018-02-12 13:48+0000\n"
"Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n"
"MIME-Version: 1.0\n"
Expand Down Expand Up @@ -66,11 +66,15 @@ msgid ""
msgstr ""

#: ../docstring of sphinx.builders.Builder.supported_remote_images:1
msgid "The builder supports remote images or not."
msgid ""
"The builder can produce output documents that may fetch external images when"
" opened."
msgstr ""

#: ../docstring of sphinx.builders.Builder.supported_data_uri_images:1
msgid "The builder supports data URIs or not."
msgid ""
"The file format produced by the builder allows images to be embedded using "
"data-URIs."
msgstr ""

#: ../docstring of sphinx.builders.Builder.default_translator_class:1
Expand Down
179 changes: 122 additions & 57 deletions locale/ar/LC_MESSAGES/extdev/markupapi.po
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Sphinx 7.4.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-06-24 06:45+0000\n"
"POT-Creation-Date: 2024-07-04 00:41+0000\n"
"PO-Revision-Date: 2018-02-12 13:48+0000\n"
"Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n"
"MIME-Version: 1.0\n"
Expand All @@ -23,27 +23,65 @@ msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:4
msgid ""
"This section describes the API for adding ReST markup elements (roles and "
"directives)."
"This section describes the API for adding reStructuredText markup elements "
"(roles and directives)."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:8
#: ../../sphinx/doc/extdev/markupapi.rst:9
msgid "Roles"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:12
#: ../../sphinx/doc/extdev/markupapi.rst:11
msgid ""
"Roles follow the interface described below. They have to be registered by an"
" extension using :meth:`.Sphinx.add_role` or "
":meth:`.Sphinx.add_role_to_domain`."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:27
msgid ""
"The *options* and *content* parameters are only used for custom roles "
"created via the :dudir:`role` directive. The return value is a tuple of two "
"lists, the first containing the text nodes and elements from the role, and "
"the second containing any system messages generated. For more information, "
"see the `custom role overview`_ from Docutils."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:38
msgid "Creating custom roles"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:40
msgid ""
"Sphinx provides two base classes for creating custom roles, "
":class:`~sphinx.util.docutils.SphinxRole` and "
":class:`~sphinx.util.docutils.ReferenceRole`."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:43
msgid ""
"These provide a class-based interface for creating roles, where the main "
"logic must be implemented in your ``run()`` method. The classes provide a "
"number of useful methods and attributes, such as ``self.text``, "
"``self.config``, and ``self.env``. The ``ReferenceRole`` class implements "
"Sphinx's ``title <target>`` logic, exposing ``self.target`` and "
"``self.title`` attributes. This is useful for creating cross-reference "
"roles."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:53
msgid "Directives"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:14
#: ../../sphinx/doc/extdev/markupapi.rst:55
msgid ""
"Directives are handled by classes derived from "
"``docutils.parsers.rst.Directive``. They have to be registered by an "
"extension using :meth:`.Sphinx.add_directive` or "
":meth:`.Sphinx.add_directive_to_domain`."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:22
#: ../../sphinx/doc/extdev/markupapi.rst:63
msgid ""
"The markup syntax of the new directive is determined by the follow five "
"class attributes:"
Expand All @@ -65,14 +103,14 @@ msgstr ""
msgid "Mapping of option names to validator functions."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:30
#: ../../sphinx/doc/extdev/markupapi.rst:71
msgid ""
"Option validator functions take a single parameter, the option argument (or "
"``None`` if not given), and should validate it or convert it to the proper "
"form. They raise :exc:`ValueError` or :exc:`TypeError` to indicate failure."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:35
#: ../../sphinx/doc/extdev/markupapi.rst:76
msgid ""
"There are several predefined and possibly useful validators in the "
":mod:`docutils.parsers.rst.directives` module."
Expand All @@ -82,136 +120,163 @@ msgstr ""
msgid "May the directive have content?"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:40
#: ../../sphinx/doc/extdev/markupapi.rst:81
msgid "New directives must implement the :meth:`run` method:"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:44
#: ../../sphinx/doc/extdev/markupapi.rst:85
msgid ""
"This method must process the directive arguments, options and content, and "
"return a list of Docutils/Sphinx nodes that will be inserted into the "
"document tree at the point where the directive was encountered."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:48
#: ../../sphinx/doc/extdev/markupapi.rst:89
msgid "Instance attributes that are always set on the directive are:"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:52
#: ../../sphinx/doc/extdev/markupapi.rst:93
msgid ""
"The directive name (useful when registering the same directive class under "
"multiple names)."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:57
#: ../../sphinx/doc/extdev/markupapi.rst:98
msgid "The arguments given to the directive, as a list."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:61
#: ../../sphinx/doc/extdev/markupapi.rst:102
msgid ""
"The options given to the directive, as a dictionary mapping option names to "
"validated/converted values."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:66
#: ../../sphinx/doc/extdev/markupapi.rst:107
msgid "The directive content, if given, as a :class:`!ViewList`."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:70
#: ../../sphinx/doc/extdev/markupapi.rst:111
msgid ""
"The absolute line number on which the directive appeared. This is not "
"always a useful value; use :attr:`srcline` instead."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:75
#: ../../sphinx/doc/extdev/markupapi.rst:116
msgid ""
"Internal offset of the directive content. Used when calling "
"``nested_parse`` (see below)."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:80
#: ../../sphinx/doc/extdev/markupapi.rst:121
msgid "The string containing the entire directive."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:85
#: ../../sphinx/doc/extdev/markupapi.rst:126
msgid ""
"The state and state machine which controls the parsing. Used for "
"``nested_parse``."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:90
msgid "ViewLists"
#: ../../sphinx/doc/extdev/markupapi.rst:131
msgid "`Creating directives`_ HOWTO of the Docutils documentation"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:139
msgid "Parsing directive content as reStructuredText"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:92
#: ../../sphinx/doc/extdev/markupapi.rst:141
msgid ""
"Docutils represents document source lines in a class "
"``docutils.statemachine.ViewList``. This is a list with extended "
"functionality -- for one, slicing creates views of the original list, and "
"also the list contains information about the source line numbers."
"Many directives will contain more markup that must be parsed. To do this, "
"use one of the following APIs from the :meth:`~Directive.run` method:"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:97
msgid ""
"The :attr:`Directive.content` attribute is a ViewList. If you generate "
"content to be parsed as ReST, you have to create a ViewList yourself. "
"Important for content generation are the following points:"
#: ../../sphinx/doc/extdev/markupapi.rst:144
msgid ":py:meth:`.SphinxDirective.parse_content_to_nodes()`"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:101
msgid ""
"The constructor takes a list of strings (lines) and a source (document) "
"name."
#: ../../sphinx/doc/extdev/markupapi.rst:145
msgid ":py:meth:`.SphinxDirective.parse_text_to_nodes()`"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:103
msgid "The ``.append()`` method takes a line and a source name as well."
#: ../../sphinx/doc/extdev/markupapi.rst:147
msgid ""
"The first method parses all the directive's content as markup, whilst the "
"second only parses the given *text* string. Both methods return the parsed "
"Docutils nodes in a list."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:107
msgid "Parsing directive content as ReST"
#: ../../sphinx/doc/extdev/markupapi.rst:151
msgid "The methods are used as follows:"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:109
#: ../../sphinx/doc/extdev/markupapi.rst:164
msgid ""
"Many directives will contain more markup that must be parsed. To do this, "
"use one of the following APIs from the :meth:`Directive.run` method:"
"The above utility methods were added in Sphinx 7.4. Prior to Sphinx 7.4, the"
" following methods should be used to parse content:"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:112
#: ../../sphinx/doc/extdev/markupapi.rst:167
msgid "``self.state.nested_parse``"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:113
#: ../../sphinx/doc/extdev/markupapi.rst:168
msgid ""
":func:`sphinx.util.nodes.nested_parse_with_titles` -- this allows titles in "
"the parsed content."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:116
#: ../../sphinx/doc/extdev/markupapi.rst:182
msgid ""
"Both APIs parse the content into a given node. They are used like this::"
"To parse inline markup, use "
":py:meth:`~sphinx.util.docutils.SphinxDirective.parse_inline()`. This must "
"only be used for text which is a single line or paragraph, and does not "
"contain any structural elements (headings, transitions, directives, etc)."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:126
#: ../../sphinx/doc/extdev/markupapi.rst:190
msgid ""
"``sphinx.util.docutils.switch_source_input()`` allows to change a target "
"file during nested_parse. It is useful to mixed contents. For example, "
"``sphinx.ext.autodoc`` uses it to parse docstrings::"
"``sphinx.util.docutils.switch_source_input()`` allows changing the source "
"(input) file during parsing content in a directive. It is useful to parse "
"mixed content, such as in ``sphinx.ext.autodoc``, where it is used to parse "
"docstrings."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:141
#: ../../sphinx/doc/extdev/markupapi.rst:208
msgid ""
"Until Sphinx 1.6, ``sphinx.ext.autodoc.AutodocReporter`` was used for this "
"purpose. It is replaced by ``switch_source_input()``."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:144
#: ../../sphinx/doc/extdev/markupapi.rst:215
msgid "ViewLists and StringLists"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:217
msgid ""
"If you don't need the wrapping node, you can use any concrete node type and "
"return ``node.children`` from the Directive."
"Docutils represents document source lines in a ``StringList`` class, which "
"inherits from ``ViewList``, both in the ``docutils.statemachine`` module. "
"This is a list with extended functionality, including that slicing creates "
"views of the original list and that the list contains information about "
"source line numbers."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:150
msgid "`Creating directives`_ HOWTO of the Docutils documentation"
#: ../../sphinx/doc/extdev/markupapi.rst:223
msgid ""
"The :attr:`Directive.content` attribute is a ``StringList``. If you generate"
" content to be parsed as reStructuredText, you have to create a "
"``StringList`` for the Docutils APIs. The utility functions provided by "
"Sphinx handle this automatically. Important for content generation are the "
"following points:"
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:229
msgid ""
"The ``ViewList`` constructor takes a list of strings (lines) and a source "
"(document) name."
msgstr ""

#: ../../sphinx/doc/extdev/markupapi.rst:231
msgid ""
"The ``ViewList.append()`` method takes a line and a source name as well."
msgstr ""
Loading

0 comments on commit 1644171

Please sign in to comment.